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Abstract 



This document describes TCP/IP V2.0 for OS/2, which is the follow-on product of 
TCP/IP V1.2.1 for OS/2. 

The document focuses on how TCP/IP V2.0 for OS/2 can be used in an 
environment with various operating system platforms, communications media, 
and protocol stacks. It provides information on installation and use of TCP/IP 
V2.0 for OS/2. 

This document is intended for the SE audience who will evaluate the product 
possibilities and who will install the product. The reader is assumed to have a 
basic knowledge of the TCP/IP protocol suite and be familiar with OS/2 and the 
OS/2 Communications Manager. For the reader interested in TCP/IP in an OS/2 
LAN Server environment, an understanding of LAN Server concepts is assumed. 
For the reader interested in TCP/IP in an SNA environment, an understanding 
the SNA architecture and its communication protocols is assumed. 

CO (412 pages) 
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Special Notices 



This publication is intended to assist the reader in installing and using TCP/IP 
V2.0 for OS/2. The information in this publication is not intended as the 
specification of any programming interfaces that are provided by TCP/IP V2.0 for 
OS/2. Seethe PUBLICATIONS section of the IBM Programming Announcement 
for TCP/IP V2.0 for OS/2 for more information about what publications are 
considered to be product documentation. 

References in this publication to IBM products, programs or services do not 
imply that IBM intends to make these available in all countries in which IBM 
operates. Any reference to an IBM product, program, or service is not intended 
to state or imply that only IBM's product, program, or service may be used. Any 
functionally equivalent program that does not infringe any of IBM's intellectual 
property rights may be used instead of the IBM product, program or service. 

Information in this book was developed in conjunction with use of the equipment 
specified, and is limited in application to those specific hardware and software 
products and levels. 

IBM may have patents or pending patent applications covering subject matter in 
this document. The furnishing of this document does not give you any license to 
these patents. You can send license inquiries, in writing, to the IBM Director of 
Commercial Relations, IBM Corporation, Purchase, NY 10577. 

The information contained in this document has not been submitted to any 
formal IBM test and is distributed AS IS. The information about non-IBM 
(VENDOR) products in this manual has been supplied by the vendor and IBM 
assumes no responsibility for its accuracy or completeness. The use of this 
information or the implementation of any of these techniques is a customer 
responsibility and depends on the customer's ability to evaluate and integrate 
them into the customer's operational environment. While each item may have 
been reviewed by IBM for accuracy in a specific situation, there is no guarantee 
that the same or similar results will be obtained elsewhere. Customers 
attempting to adapt these techniques to their own environments do so at their 
own risk. 



The following document contains examples of data and reports used in daily 
business operations. To illustrate them as completely as possible, the examples 
contain the names of individuals, companies, brands, and products. All of these 
names are fictitious and any similarity to the names and addresses used by an 
actual business enterprise is entirely coincidental. 

The following terms, which are denoted by an asterisk (*) in this publication, are 
trademarks of the International Business Machines Corporation in the United 
States and/or other countries: 



ACF/VTAM 

AlXwindows 

AnyNet/MVS 

APPN 

BookManager 

C/2 

CICS/MVS 

DB2/2 



AIX 
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AS/400 

BookM aster 

CICS OS/2 

CUA 

ES/3090 
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Preface 



This document describes TCP/IP V2.0 for OS/2. 

The document focuses on how TCP/IP V2.0 for OS/2 can be used in an 
environment with various operating system platforms, communications media, 
and protocol stacks. It provides information on the installation and use of TCP/IP 
V2.0 for OS/2. 

This document is intended for the SE audience who will evaluate the product 
possibilities and who will install the product. The reader is assumed to have a 
basic knowledge of the TCP/IP protocol suite and be familiar with OS/2 and the 
IBM Extended Services/2 V1.0 and its Communications Manager, or of IBM 
Communications Manager/2 VI .0 respectively. 

A basic knowledge of IBM OS/2 LAN Server V3.0 is assumed for the chapters 
dealing with the NetBIOS and NFS Kits. 

A basic knowledge of the SNA architecture and its communication protocols is 
assumed for the chapters dealing with the extended networking capabilities of 
TCP/IP V2.0 for OS/2. 

It is not the intention of this document to replace the original product 
documentation, or to teach how to develop applications using the Programming 
Kit and the APIs that it provides. 



How This Document is Organized 

The document is organized as follows: 

• Chapter 1. “Introduction and Overview” 

This chapter lists the system requirements for TCP/IP V2.0 for OS/2, and 
describes the functions of the product, especially highlighting new features 
that did not exist in previous versions of TCP/IP V2.0 for OS/2. 

• Chapter 2, "Installation and Configuration” 

This chapter provides information about the installation and customization of 
TCP/IP V2.0 for OS/2, especially covering the newly implemented feature of 
remote install according to the IBM Configuration, Installation, and 
Distribution architecture (C.I.D.), and it describes how to set up a serial line 
connection (SLIP). 

• Chapter 3, "Remote Logon” 

This chapter describes the remote logon and terminal emulation facilities of 
TCP/IP V2.0 for OS/2, its interoperability with the 3270 (VM, MVS), 5250 
(AS/400), UNIX (AIX), DOS, and OEM TCP/IP services, and their integration 
into the OS/2 Workplace Shell. 

• Chapter 4, “File Transfer” 

This chapter describes the file transfer facilities of TCP/IP V2.0 for OS/2, its 
interoperability with the 3270 (VM, MVS), 5250 (AS/400), UNIX (AIX), DOS, and 
OEM TCP/IP services, and its integration into the OS/2 Workplace Shell. 

• Chapter 5, “Remote Printing” 
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This chapter describes the remote printing capabilities of TCP/IP V2.0 for 
OS/2 using LPD, and its integration into the OS/2 Workplace Shell. 

Chapter 6, “Remote Execution of Commands” 

This chapter describes remote command execution using REXEC and RSH. 
Chapter 7, “Domain Name Server” 

This chapter describes the new Domain Name Server capability of TCP/IP 
V2.0 for OS/2, and the management tools that come along with it. 

Chapter 8, “Electronic Mail, NewsReader/2, TALK” 

This chapter describes the electronic mail functions on OS/2 workstations 
using SMTP (Simple Mail Transfer Protocol), the new News Reader /2 
application, and the TALK protocol. 

Chapter 9, “UltiMedia Mail/2” 

This chapter describes how to install and configure the UltiMedia Mail/2 Kit. 
The 822 and 1521 RFCs are also discussed in this chapter. 

Chapter 10, “Remote File Systems” 

This chapter describes how to share and access remote file systems using 
NFS, and its interoperability with the VM, MVS, AIX, DOS, and OEM TCP/IP 
services. 

Chapter 11, “X Windows System Server (PMX)” 

This chapter describes the X Window System Server function available with 
TCP/IP V2.0 for OS/2. 

Chapter 12, “X Window System Client and OSF/Motif Kits” 

This chapter describes the new X Window System Client functions available 
with TCP/IP V2.0 for OS/2. 

Chapter 13, “DOS/Windows Access Interface” 

This chapter describes the new DOS/Windows box Socket interface of TCP/IP 
V2.0 for OS/2. 

Chapter 14, “NetBIOS Interface” 

This chapter describes how to allow NetBIOS applications to communicate 
across a TCP/IP network using the TCP/IP V2.0 for OS/2 NetBIOS Kit 
(previously known as NetBIOS 1.0 for TCP/IP for OS/2). 

Chapter 15, “Extended Networking: X.25 and SNALINK" 

This chapter describes the new SNALINK feature of TCP/IP V2.0 for OS/2, 
and it illustrates how to connect TCP/IP V2.0 for OS/2 to an X.25 network 
using IBM Communications Manager/2 VI .0. 

Chapter 16, “Network Management and Interconnection" 

This chapter discusses the SNMP (Simple Network Management Protocol) 
network management functions and tools available with TCP/IP V2.0 for 
OS/2, and describes the IP routing capabilities of the product. 

Chapter 17, "Problem Determination" 

This chapter describes the problem determination facilities provided with 
TCP/IP V2.0 for OS/2. 

Chapter 18, "Application Programming Interfaces" 




This chapter describes the programming interfaces of TCP/IP V2.0 for OS/2. 

• Chapter 19, “AnyNet/2 and OSF/DCE for OS/2" 

This chapter describes the interoperability between TCP/IP V2.0 for OS/2 and 
AnyNet/2, and explains how to run OS/2 TCP/IP applications on top of the 
IBM Multi Protocol Transport Network architecture. It also gives you a brief 
introduction to OSF/DCE. 

• Chapter 20, “TCP/IP V2.0 for OS/2 and NetWare Coexistence” 

This chapter describes the interoperability between TCP/IP V2.0 for OS/2 and 
NetWare. It shows the possible configurations for this coexistence. 

• Appendixes 

Appendix A and B contain configuration listings of the systems that have 
been used for the testing scenarios of this document. 



Related Publications 

The publications listed in this section are considered particularly suitable for a 
more detailed discussion of the topics covered in this document. 

TCP/IP V2.0 for OS/2 product documentation: 

• IBM TCP/IP V2.0 for OS/2: Installation and Administration, SC31-6075-04 

• IBM TCP/IP V2.0 for OS/2: User's Guide, SC31-6076-04 
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Documentation on OEM products: 

• HCL-eXceed/W for Microsoft Windows: User's Guide 

Valuable TCP/IP documentations: 
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Chapter 1. Introduction and Overview 



This chapter describes the functions and features of the TCP/IP V2.0 for OS/2 
product and the additional kits that are available for it. 



1.1 Product Overview 

TCP/IP V2.0 for OS/2* gives the user at an OS/2 workstation attached to a TCP/IP 
network the following components: 

1. TCP/IP clients which can be run in OS/2 full-screen, text windows or from the 
OS/2 Workplace Shell* 

2. TCP/IP servers which can be started in OS/2 full-screen sessions, text 
windows, or from the OS/2 Workplace Shell 

3. Network status commands to query the status of local and remote 
workstations 

4. Device drivers and configuration programs to access a LAN or a serial line 
(you need additional software to access an X.25 link or an SNALINK 
interface). 

5. A methodology to install many workstations remotely from a single server 
providing the necessary product files 

6. Tools for developing network client/server applications 

7. Online publications and a utility program that displays them. 

The product is split into functional packages, called kits, that provide the 
functions shown in Table 1 on page 2: 
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Table 1 (Page 1 of 2). TCP/IP V2.0 for OS/2 Functional Packages (Kits) 



Package 


Functions 


Base Kit 


Base TCP/IP functions: 

• Telnet 

• FTP 

• TFTP 

• REXEC 

• RSH 

• Remote Printing 

• SMTP 

• LaMail 

• NewsReader/2 

• TALK 

• SNMP 

• Routing 

• ARP 

• PING 

• BOOTP 

LAN Adapter and Protocol Support (LAPS) 

Frame Relay Support 

IBM Library Reader/2 

Redirected Installation Method (C.I.D.) 

FDDI Support 

Configuration Notebook 

Online Publications 

Portmapper 

Serial Line Internet Protocol (SLIP) 


Network File System Kit 


NFS Server 
NFS Client 

Redirected Installation Method (C.I.D.) 
Configuration Notebook 
Online Publications 
IBM Library Reader/2 


Extended Networking Kit 


X.25 

SNALINK 

Redirected Installation Method (C.I.D.) 
Configuration Notebook 
Online Publications 
IBM Library Reader/2 


Domain Name Server Kit 


Domain Name Server 
Utilities 

Redirected Installation Method (C.I.D.) 
Online Publications 
IBM Library Reader/2 


Ulti Media Mail/2 Kit 


UltiMail Server 
UltiMail Client 
UltiMail Tutorial 

Redirected Installation Method (C.I.D.) 
Configuration Notebook 


DOS/Windows Access Kit 


Virtual Device Driver 

DOS Socket Interface 

WinSock Interface 

WinSock Documentation 

Redirected Installation Method (C.I.D.) 
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Table 1 (Page 2 of 2). TCP/IP V2.0 for OS/2 Functional Packages (Kits) 



Package 


Functions 


Programming Kit 


32-bit APIs 
Samples 

Redirected Installation Method (C.I.D.) 
Online Publications 
IBM Library Reader/2 


X Window System Server Kit 


X Server Version 1 1 Release 5 
Utilities 

Redirected Installation Method (C.I.D.) 
Configuration Notebook 
Online Publications 
IBM Library Reader/2 


X Window System Client Kit 


X Client APIs 
Samples 

Redirected Installation Method (C.I.D.) 
Online Publications 
IBM Library Reader/2 


NetBIOS Kit 


NetBIOS over TCP/IP 


Applications Kit 


Base Kit without: 

• TCP/IP Protocol Stack 

• LAPS 

• SLIP 


Total Kit 


All of the following Kits: 

• Base 

• NFS 

• Extended Networking 

• X Window System Server 


OSF/Motif** Kit 


OSF/Mofif VI .2 Client APIs 
Samples 


Asia/Pacific Kit 


Base Kit plus DBCS Support 



1.1.1 New Functions and Features 

The following list shows what has been added to this version of TCP/IP for OS/2: 

• 32-bit APIs 

• TN5250 

• HFT terminal type support for Telnet 

• Workplace Shell integration of selected functions 

• C.I.O. enablement for network installation 

• File locking support for NFS client 

• DOS/Windows access 

• SNALINK LU6.2 support 

• 32-bit X Window System server 

• X Window System client support 

• OSF/Motif Client support 

• UltiMedia Mail/2 Kit. Client and Server support 

• TN3270 external translation tables 
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• SNMP DPI VI. 1 enhancements 

• SLIP scripting capability and VJ compression 

• Frame Relay support 

• FDDI support 

• Applications Kit for different protocol stack 

• Online Publications and IBM Library Reader/2 



1.2 Functional Overview 

This section gives a brief description of the functions and features provided by 
TCP/IP V2.0 for OS/2. 

1.2.1 TCP/IP Clients 

TCP/IP V2.0 for OS/2 has the following clients implemented: 

Telnet Telnet in TCP/IP for OS/2 supports ASCII (ANSI, VT100**, VT220**, HFT, 
and NVT) and EBCDIC (3270, 5250) terminals for logging on to other TCP/IP 
hosts. Telnet is also integrated in the OS/2 Workplace Shell. 3270 Telnet is 
implemented as a Presentation Manager (Telnet3270), and as an OS/2 full-screen 
or window application (TN3270). 5250 Telnet is implemented as a Presentation 
Manager application (TN5250). 

Telnet3270: Telnet3270 is a 3270 terminal emulator that supports all 3270 
terminal types, extended colors, and a copy to PM clipboard function. A number 
of different fonts can be selected to control the size of the window. It runs as a 
Presentation Manager task and is integrated in the OS/2 Workplace Shell. 

FTP: File Transfer Protocol supports file transfer to/from other TCP/IP hosts. 

FTPPM: FTPPM is the Presentation Manager version of the FTP client and is 
integrated in the OS/2 Workplace Shell. The application is based on selection 
lists. 

TFTP: Trivial File Transfer Protocol is an alternative to transferring files with 
FTP. It does not provide all the features available in FTP. 

REXEC: REXEC enables remote command execution on other TCP/IP hosts. 

RSH: RSH enables remote command execution on other TCP/IP hosts. 

LPR: Remote Printing Protocol allows remote printing on other TCP/IP hosts. 

The line printer client (LPR) sends the file to be printed to a specified print 
server host and to a specific printer. 

LPRMON: LPRMON is a Parallel Device Monitor that allows you to set up your 
PC to automatically send data to a remote LPR server. 

LPR Ports: LPR ports provide output to a remote TCP/IP printer from within a 
printer object of the OS/2 Workplace Shell. 

NFS: The NFS client enables you to mount remote file systems and access them 
like local disk drives. 
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Portmapper: When a client wishes to access an RPC service, like NFS, it first 
send an enquiry including the program, procedure and version numbers together 
with the type of the desired protocol to the port mapper of the target computer. It 
receives the port number of the service by return and can then send the request 
directly to the server. 

SENDMAIL: The OS/2 mail server that uses SMTP to route mail from one host 
to another host on the network. A file can be piped to the SENDMAIL server by 
invoking SENDMAIL in foreground mode. Normally, the OS/2 user will use the 
Presentation Manager* LaMail application instead. 

LaMall: LaMail is a Presentation Manager electronic mail application which 
uses the SENDMAIL server to exchange mail with different environments based 
on the Simple Mail Transfer Protocol (SMTP). LaMail supports send, receive, 
reply and the forwarding of mail. The user can organize his mail in folders. 
LaMail also contains a Presentation Manager editor that can be used for normal 
file editing as an alternative to the OS/2 system editor. 

UltiMedla MaU/2 Client UltiMedia Mail/2 is an electronic mail system used to 
exchange mail with different environments based on the Simple Mail Transfer 
Protocol (SMTP) and the MIME extension of RFC 822, which allows you to send 
multimedia mail using the TCP/IP network. 

TALK: TALK together with the TALKD server enables Interactive conversations 
with a user at another TCP/IP host. 

NewsReaderl2: NewsReader/2 (NR/2) is a Presentation Manager application 
which allows you to access USENET news servers on an Internet. News servers 
contain a broad range of news groups that can be viewed, subscribed, and 
appended to by NR/2. 

BOOTP: BOOTP is used to obtain a hosts internet address, subnet mask, default 
IP router address, host name, and domain name from a BOOTPD server on the 
local LAN by broadcasting its network adapter address using the BOOTP 
protocol. 

X Window System Clients: The X Window System Client Kit provides a few X 
Client sample programs that are ready to use if the OS/2 X Server is installed. 

DOSIWindows Clients: The DOS/Windows Access Kit enables DOS and 
Windows applications that were originally written using the APIs provided by IBM 
TCP/IP V2.1 for DOS, to run in an OS/2 Virtual DOS Machine or WIN-OS/2 
session, using the TCP/IP protocol stack provided by TCP/IP V2.0 for OS/2. 

1.2.2 TCP/IP Servers 

With the TCP/IP V2.0 for OS/2 product, you can set up the following servers: 

TELNETD: TELNETD supports ANSI, VT100, and VT220 terminals in OS/2 
full-screen mode. 

FTPD: FTPD supports file exchange using the File Transfer Protocol with other 
TCP/IP hosts. 

TFTPD: TFTPD supports file exchange using the Trivial File Transfer Protocol 
with other TCP/IP hosts. You can restrict access for remote clients to files in a 
single directory. 
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REXECD: REXECD executes OS/2 commands issued from other TCP/IP hosts. 

RSHD: RSHD executes OS/2 commands issued from other TCP/IP hosts. 

LPD: LPD interfaces to the OS/2 print spooler and makes it possible to share an 
OS/2 printer with other TCP/IP workstations. 

INETD: This server incorporates all servers mentioned so far by starting them 
within a single task. This reduces system overhead, but you cannot specify 
parameters to a server if it is started by INETD. 

LPRPORTD: This server provides the capability to print using LPR port icons. 

SENDMAIL: SENDMAIL implements SMTP to transmit mail to and receive mail 
from other TCP/IP hosts. 

UltlMedla Malll2: UltiMedia Mail/2 implements SMTP and the MIME extension of 
822 RFC to exchange multimedia mail between TCP/IP hosts. 

TALKD: TALKD together with the TALK client supports interactive conversation 
with a user at another TCP/IP host. 

ROUTED: An OS/2 workstation connected to two LANs works as an Internet 
gateway. ROUTED expands the basic routing capabilities of the Internet Protocol 
(IP) by using the Routing Information Protocol (RIP) to maintain its routing table. 

SNMPD: The Simple Network Management Protocol agent (SNMPD) can 
communicate with an SNMP network management host (an SNMP Monitor) and 
with SNMP subagents to provide network management support in a TCP/IP 
environment. 

NFSD: The NFS server enables you to export directories of an OS/2 system so 
that users running an NFS client can mount them and access them like local disk 
drives. You can restrict access to certain directories to selected systems, and 
you can export directories read-only. 

Portmapper. The port mapper program maps RPC program and version 
numbers to transport-specific port numbers. This program makes dynamic 
binding of remote programs possible. This is desirable because the range of 
reserved port numbers are very small and the potential remote programs is very 
large. 

PMX: PMX is the Presentation Manager X Window System Server. It allows the 
user to run remote X client applications and display them locally. 

NAMED: The name server does the Internet-to-name translation on one 
centralized system. Remote systems can ask to get the internet address for a 
certain name. 

BOOTPD: BOOTPD sends an internet address, subnet mask, default IP router 
address, host name, and domain name to a BOOTP client on the local LAN that 
broadcasts its network adapter address using the BOOTP protocol. 

DOSIWindows Servers: The DOS/Windows Access Kit enables DOS and 
Windows applications that were originally written using the APIs provided by IBM 
TCP/IP V2.1 for DOS, to run as a server in an OS/2 Virtual DOS Machine or 
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WIN-OS/2 session, using the TCP/IP protocol stack provided by TCP/IP V2.0 for 
OS/2. 



1.2.3 Network Status Commands 

The OS/2 user can obtain network status information by using the following 
commands: 

PING: PING is a command that polls a foreign host to determine if the foreign 
host is accessible. It is used as a diagnostic tool. 

PMPING: PM PING is a Presentation Manager program that uses PING to 
monitor a list of hosts, which you define in the PINGHOST.LST file. 

NETSTAT: NETSTAT allows the user to display the network status of the local 
computer. 

ARP: ARP allows the user to obtain, modify, or delete information about the 
lnternet-to-hardware address mapping table of a workstation. 

SNMP: SNMP allows the user to send individual GET and GET_NEXT PDUs to 
another TCP/IP host running an SNMP agent. 

SNMPGRP: SNMPGRP allows the user to display a MIB-II group of another 
TCP/IP host running an SNMP agent. 

SNMPTRAP: SNMPTRAP is a Presentation Manager program that displays 
SNMP TRAPs received from any SNMP agent in the network. 

FINGER: FINGER allows the user to display information about the users on 
another TCP/IP host that runs a FINGER server. 

1.2.4 Tools for Developing Network Applications 

TCP/IP V2.0 for OS/2 and its Programming Kit provide you with the following 
Application Programming Interfaces: 

• Berkley sockets and Sun RPC for development of cooperative processing 
client/server applications between an OS/2 workstation and another TCP/IP 
host supporting these interfaces. 

• A distributed programming interface (DPI) to the SNMPD agent in OS/2 which 
makes it possible to dynamically add objects to the Management Information 
Base (MIB) and generate alerts (TRAPs) that are forwarded by SNMPD to a 
SNMP network management host. 

• An FTP API allows the user to execute a file transfer from within an 
application. All the FTP subcommands used during an FTP session, can be 
invoked and controlled by a user program. 

• Support for developing client applications according to the X Window System 
is provided by the X Window System Client Kit. 
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1.2.5 Configuration, Installation, and Distribution (C.I.D.) 

TCP/IP V2.0 for OS/2 provides a method that allows you to set up a code server 
from where you can install OS/2 TCP/IP workstations remotely. This will make 
installation of a large number of workstations much easier since you are no 
longer required to use diskettes for installing TCP/IP V2.0 for OS/2. Moreover, 
you can install several workstations at the same time using the same code 
server. 

The method for remote installation provided with TCP/IP V2.0 for OS/2 uses NFS 
server and NFS clients. It also provides procedures to create bootable diskettes 
for installing the product. The ability to install TCP/IP V2.0 for OS/2 from a 
remote drive, however, is not restricted to that method. You can also use other 
means to redirect a drive for installing TCP/IP V2.0 for OS/2 to the workstation to 
be installed, like one of the following: 

• NFS mount from a Unix server 

• IBM OS/2 LAN Server V3.0 

• Novell NetWare 3.11 server 

• C.I.D. using Network Transport Services/2 

1.2.6 Workplace Shell Integration and Configuration Notebook 

TCP/IP V2.0 for OS/2 creates a TCP/IP folder on your OS/2 desktop where it 
places objects for several of its functions. This is shown in the following figure: 



TCP/IP - Icon View 






n 



SUPTERM: Modem Setup SNMPTRAP TCP/IP Command Ref «ence 



i 

; 

i 









TFTP TN5250 TCP/IP Usef’s Guide TCP/IP Installation end Administration Start NFS 



Figure 1 . TCP/IP Folder on OS/2 Desktop 



One of these objects, TCP/IP Configuration, is the Configuration Notebook. It 
provides you with a comprehensive interface to configure TCP/IP V2.0 for OS/2 
and its additional packages, similar to the Setting pages of an OS/2 Workplace 
Shell object. 

You need to use the Configuration Notebook to fully set up your TCP/IP 
environment after the installation of the product is complete. There are only a 
few basic parameters to be specified during installation. 

Also integrated into the OS/2 Workplace Shell are the TelnetPM, Telnet3270, and 
FTPPM clients, and the LPR port printer objects. 
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1.2.7 LAN Adapter and Protocol Support (LAPS) 

LAPS provides network adapter drivers that adhere to the Network Driver 
Interface Specification (NDIS**); it supports and provides the TCP/IP protocol 
driver. It is a Presentation Manager application that allows you to install and 
configure your network adapter interfaces. 

1.2.8 Online Documentation 

TCP/IP V2.0 for OS/2 and most of the additionally available kits provide both 
online copies of the product documentation manuals and a tool to view those 
manuals. The online publications are provided in IBM BookManager Read/2* 
format, and they can be viewed using IBM Library Reader/2, as shown in the 
following figure: 




BookManager Books and Bookshelves 



APPC over TCP/IP Guide 



IBM TCP/IP Version 2.0 lor OS/2: Programmer's Reference 

Sockets over SNA Guide 

TCP/IP for OS/2: Domain Nsme Server Guide 

TCP/IP for OS/2: Extended Networking Guide 

TCP/IP for OS/2: Installation and Administration 

TCP/IP for OS/2: NFS 

TCP/IP for OS/2: PMX 

TCP/IP for OS/2: User's Guide 

TCP/IP for OS/2: X Window System Client 




IBM Library Reader 10 of 10 



Date Document 



-93 11:43:18 



Si 



1-93 14:57:38 SC31-6 

J-93 11:45:52 SV40 

1- 93 08:38:09 SC31-7 

2- 93 17:29:56 SC31-7 

2-93 08:58:31 SC31-6 

5-93 08:15:27 SC31-7 

1-93 14:19:38 SC31-7 

9-93 10:30:20 SC31-6 

1-93 09:50:32 SC31-7 






m 









Figure 2. Viewing TCP/IP V2.0 for OS/2 Online Publications 



In order to save disk space on your OS/2 system, you can install the online 
publications on a shared network drive and read it from there. Online 
documentation is provided for all kits except the following: 

• DOS/Windows Access Kit (provides a README file and documentation of the 
WinSock interface) 



In addition to these online manuals, some kits provide a README file, and the X 
Window System Server Kit also provides online information that can be viewed 
using the OS/2 view command. 



1.2.9 Functions and Features No Longer Contained in TCP/IP V2.0 for OS/2 

The following functions and features were contained in previous versions of 
TCP/IP V2.0 for OS/2 but are now no longer part of the product: 

KERBEROS: KERBEROS may be found in the DCE for OS/2 product. 

NCS API: This API is no longer provided. 
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NSTAT: This program used to be a sample program and its source used to be 
stored in the \TCPIP\SAMPLES\NSTAT subdirectory. You can still use NSTAT 
with TCP/IP V2.0 for OS/2 if you saved a version of it. NSTAT allows the user to 
display the network status of the local computer, based on the relevant protocol 
levels, as a Presentation Manager application. It is, basically, a Presentation 
Manager version of the NETSTAT command. 



1.3 TCP/IP for OS/2 Interoperability Summary 

The tables below shows how the functions provided with TCP/IP V2.0 for OS/2 
and its additionally available kits can cooperate with TCP/IP implementations on 
other IBM system platforms. 



Table 2. OS/2 Client Interoperability with IBM Servers 




TCP/IP Server 


OS/2 TCP/IP 


OS/2 


VM 


MVS 


DOS 


AIX 


AIX 


AIX 


AIX 






Client 


2.0 


V2R2 


V2R2 


2.1 


PS2 


RT 


RS 


ESA 


AS/400 


S/88 


ANSITERM 


X 








X 


X 


X 


X 






TN 


X 


X 


X 




X 


X 


X 


X 


X 


X 


VT1G0 


X 








X 


X 


X 


X 


X 


X 


VT220 










X 


X 


X 


X 




X 


HFT 










X 


X 


X 


X 






TN3270 




X 


X 












X 




TN5250 


















X 




FTP 


mm 


X 


mm 


X 


X 


X 


X 


X 


X 


X 


TFTP 








X 


X 


X 


X 


X 






LPR/LPRMON 


X 


X 


X 




X 


X 


X 


mm 






REXEC 


X 


X 






X 


X 


X 


X 






RSH 


X 


X 






X 


X 


X 


X 






SENDMAIL 


X 


X 


X 


X 


X 


X 


X 


X 


X 




UltiMail 


B 


X 


X 


X 


X 


X 


X 


X 


X 




FINGER 










X 


X 


X 


X 






TALK 


X 








X 


X 


X 


X 






DNS 


X 


X 


X 




X 


X 


X 


X 






SNMP 


X 


X 


X 








X 




X 




NFS 


X 


X 


X 




X 


X 


X 




X 


X 


X Window 


X 






XI 


X 


X 


X 








SOCKETS 


X 




X 


X 


X 


X 


X 


mm 






RPC 


X 


X 


X 


X 


X 


X 


X 


X 




X 


Notes: 






















1. Using OEM Software 





















Table 2 shows how OS/2 TCP/IP clients can interoperate with different IBM 
TCP/IP servers. 
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Table 3. OS/2 Server Interoperability with Other IBM Clients 




TCP/IP Client 


OS/2 TCP/IP 


OS/2 


VM 


MVS 


DOS 


AIX 


AIX 


AIX 


AIX 






Server 


2.0 


V2R2 


V2R2 


2.1 


PS2 


RT 


RS 


ESA 


AS/400 


S/88 


TELNETD 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X Windows 


X 


X 


X 


Xi 


X 


X 


X 


X 






TALKD 


X 








X 


X 


X 


X 






FTPD 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


TFTPD 


X 


X 




X 


X 


X 


X 


X 






LPD 


X 


X 


X 


X 


X 


X 


X 


X 






LPRPORTD 


X 


X 


X 


X 


X 


X 


X 


X 






REXECD 


X 


X 


X 


X 


X 


X 


X 


X 






RSHD 


X 








X 


X 


X 


X 






SENDMAIL 


X 


X 


X 


X 


X 


X 


X 


X 


X 




UltiMail 


X 


X 


X 


X 


X 


X 


X 


X 


X 




DNS 


X 


X 


X 


X 


X 


X 


X 


X 


X 




SNMPD 


X 


X 


X 








X 








NFS 


X 






X 


X 


X 


X 


X 


X 




ADM_SERV 


X 


X 










X 








SOCKETS 


X 


X 


X 


X 


X 


X 


X 


X 






WINSOCK 


X 


X 


X 


X 


X 


X 


X 


X 






RPC 


X 


X 


X 


X 


X 


X 


X 


X 




X 


Notes: 






















1. Using OEM Software 





















Table 3 shows how OS/2 TCP/IP servers can interoperate with different IBM 
TCP/IP clients. 



1.4 ITSC Raleigh Test Environments 

The figures below show the test environments to which the following chapters 
will occasionally refer. We documented installation and operation of the systems 
in our lab environment as an example. 

Since it would have been too complex to show the whole setup in a single 
picture, we grouped the environments for our test scenarios as follows: 

1. OS/2 systems and local networks 
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Figure 3. TCP/IP Test Environment for OS/2 Systems and on the Local LAN 



2. OS/2 and Mainframe systems 




Figure 4. TCP/IP Test Environment for OS/2 and Host Systems 



3. OEM systems and remote networks 
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ckJserver 

9 . 67 . 38.115 




Figure 5. TCP/IP Test Environment for OEM Systems and on Remote Networks 

Detailed configurations of the systems shown in the above figures can be found 
in: 

1. Appendix A for OS/2 and DOS systems 

2. Appendix B for non-PS/2 and OEM systems 
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Chapter 2. Installation and Configuration 



This chapter describes the system requirements for TCP/IP V2.0 for OS/2. We 
also describe our test environment at the ITSC, and provide step by step 
instructions for several installation scenarios for TCP/IP V2.0 for OS/2 



2.1 System Requirements 

This section describes the hardware and software prerequisites for TCP/IP V2.0 
for OS/2. 

2.1.1 Hardware Prerequisites 

TCP/IP V2.0 for OS/2 requires the following hardware: 

• Computer Models 

Any PC that can support Operating System/2 V2.0 or higher. When all 
software components are installed, TCP/IP V2.0 for OS/2 will use an extra 
7MB of memory and 35MB of additional fixed disk space. If you are planning 
to use Extended Networking you will need to consider the additional system 
requirements of IBM Communications Manager/2 V1.0. 

Note ! 

To use an X.25 interface with TCP/IP, you will also need a personal 
computer with a Micro Channel bus. 



• Computer accessories 

— All accessories required by OS/2 

— For access to the Internet using a modem, a Hayes** AT-compatible 
modem 

• Network adapters 
Micro Channel adapters 

— IBM Adapter/A for Ethernet Networks 

— IBM PC Network Adapter ll/A-Frequency 2 

— IBM PC Network Adapter ll/A-Frequency 3 

— IBM PC Network Baseband Adapter/A 

— IBM PC Network Baseband Adapter ll/A 

— IBM Token-Ring Network Adapter/A 

— IBM Token-Ring Network Adapter 16/4 /A (part number 16F1133) 

— IBM Token-Ring Network Adapter 16/4 /A {part number 75F9410) 

— IBM Token-Ring Network 16/4 Bus Master Server Adapter/A 

— IBM LANStreamer MC 32 Adapter 

— IBM 3270 Connection, DFT 

— Standard Microsystems** EtherCard PLUS/A Network Adapter 

— Ungermann-Bass** NIUps Network Adapter 

— 3Com** 3C523 Etherlink/MC Adapter 

— IBM FDDI Copper Base Adapter/A 

— IBM FDDI Copper Extender Adapter/A 

— IBM FDDI Fiber Base Adapter/A 

— IBM FDDI Fiber Extender Adapter/A 



© Copyright IBM Ccrp. 1990 1992 1993 
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ISA adapters 

— IBM PC Network Adapter 11-Frequency 2 

- IBM PC Network Adapter 11-Frequency 3 
— IBM PC Network Baseband Adapter 

— IBM PC Network Baseband Adapter II 
— IBM Token-Ring Network Adapter 
— IBM Token-Ring Network Adapter II 
— IBM Token-Ring Network Adapter 16/4 
— IBM Advanced 3278/79 Emulation Adapter 
— Standard Microsystems Ethercard PLUS Adapter 
— Ungermann-Bass NIUpc Network Adapter 

— 3COM 3C503 Etherlink II Network Adapter 

To run X.25, you need the following network adapter: 

IBM X.25 Interface Coprocessor/2 

• Network communication media 

One of the following: 

IBM PC Network LAN 
IBM Token-Ring LAN 
Ethernet LAN 
Serial line 
X.25 link 

Once the LANs are in place, you can interconnect them with gateways to 
form an Internet. 

If a serial line is used, the following line speeds are supported: 

1200 bps 
2400 bps 
4800 bps 
9600 bps 
19200 bps 
38400 bps 

Note: All line speeds are given in bits per second. 

2.1.2 Software Prerequisites 

TCP/IP V2.0 for OS/2 requires OS/2 Version 2.0 or higher. It also requires the 
LAN Adapter and Protocol Support (LAPS), which is included in the Base Kit. If 
you plan to use X.25 or SNALINK as your communication medium, TCP/IP for 
OS/2 also requires either OS/2 Extended Services, Version 1.0, or 
Communications Manager/2, Version 1.0. 

If you plan to write your own applications, using the programming interfaces of 
Transmission Control Protocol/Internet Protocol, or you will be modifying the 
source code provided, you need a 32-bit ANSI compiler such as C Set/2. 

PMX requires 2.0 Service Pack 32-bit graphics engine. 
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2.2 Memory and Disk Space Requirements 

This section lists hardware and software requirements for TCP/IP V2.0 for OS/2. 

Operating System and Communications Manager requirements are taken from 
IBM Communications Manager/2 Hardware and Software Reference S04G-1014, 
and Operating System/2 V2.1 Systems Administrator's Guide for Communications 
S01F-0302. 



2.2.1 Fixed Disk Requirements 

Table 4 shows the amount of fixed disk required for TCP/IP 1.2.1 for OS/2 
components. 



Table 4. Fixed disk Requirements for TCPftP 2.0 for OS/2 


Functions 


Required Disk (MB) 


Operating System 


OS/2 2.0 


OS/2 2.1 


Base (required) 


15.0 


15.0 


Base (optional)i 


15.0 


20.0 


Segment Swap Data Seti 


8.0 


8.0 


TCP/IP 2.0 Base 


7.39 


Online Publications for Base 


1.40 


LAMail 


1.90 


IBM Library Reader 


1.32 


NFS 


1.10 


NFS TCPIP CID Install 


0.25 


DOS Box Kit 


0.56 


WINSOCK Documentation 


2.00 


Extended Networking Kit 


0.96 


Programmer's Toolkit 


0.85 


PMX Kit 


11.36 


X-Client Runtime Services 


2.38 


X-Client Programmer's Toolkit 


1.44 


Domain Name Server Kit 


0.75 


NetBIOS/2 


0.11 


Communications Manager/2 for X.25 
and SNALINK 


11.2 


11.2 


Notes: 

1. A 2MB to 10MB swap area is adequate for many environments. However, swap 
area is dynamically allocated as applications require more memory than is 
available. A swap data set larger or smaller than shown may be needed. This 
estimate assumes 16MB of memory is already installed on the machine. 
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2.2.2 Memory Requirements 

Table 5 shows the amount of memory required for some of the TCP/IP 2.0 for 
OS/2 components. 



Table 5. Memory Requirements for TCP/IP 2.0 for OS/2 


Functions 


Required Memory (MB) 


Operating System 


OS/2 2.0 


OS/2 2.1 


OS/2 and TCP/IP Base 


8.0 


8.0 


LA-Mail 


1.3 


NewsReader/2 


1.5 


SNMP 


0.4 


NFS Client 


1.1 


NFS Server 


0.4 


Portmapper 


0.4 


PMX ServeM 


8.0 


Domain Name Server 


1.0 


NetBIOS/2 


0.6 


Each other Client 


0.2 


Each other Server 


0.2 + 0.2 per Client at each Server 


Communcations Manager for X.25 
and SNALINK 


1.2 


1.2 


Notes: 

1. The actual amount of memory required by PMX depends upon which and how 
many X clients are running. 



2.3 Installation 



Like previous versions of TCP/IP for OS/2, the software can be installed from 
diskettes. However, TCP/IP V2.0 for OS/2 also complies with IBM's 
Configuration, Installation, and Distribution (C.I.D.) architecture, which provides 
for installations from a code server. 

2.3.1 Installation from Diskettes 

1. If you are upgrading from a previous version of TCP/IP for OS/2, then make 
sure that you make a backup copy of your ETC directory. 

2. Insert the first diskette of the Base Kit in the diskette drive. 

3. Type this command at an OS/2 command prompt: 

a:tcpinst 
Press Enter. 

4. Select the components for installation 

5. Type in your: 

• Base directory for the installation 

• Hostname 

• IP address 

• Subnet mask 
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• Router IP Address 
Your panel will look similar to Figure 6. 



-.TCP/ IPInstaUatik? -Toot' v*r, 



Transmission Control Protocol/ Internet Protocol for Operating System/2 > 
ISelect components for Installation: 






1.90 MBytes) LaMail 
( 1.32 MBytes) IBM Library Reader 



( 0^25 MBytes) NFS TCPIP CID Install 
| 0.56 MBytes) DOS Box Kit 
( 2.00 MBytes ) WINSOCK Documentation 

MK 



|0;$6IMBytes 



( 0.85 MBytes) Programmer's Toolkit 
(11.36 MBytes) PMX Kit 

S3 instaU/nm LAN Adapter and Protocol Support 
[2 Configure network connection 

network configuration (optional) 

" |b? 



Host name ‘ ^ 
IP A*kess: / .||}S 








UMMotam 



Subnet Mask: ^$|/y^:- {255.255.255.192 

••> , A rj ■ :£'aVi ' 

Router IP Address^^^.67.38.75 



Instil I 1-V0. 

- » L 




Figure 6. TCP/IP Installation Tool 

6. Click on Install to start the installation. 

7. If there is a chance that there will be inadequate space for the installation to 
complete, then this panel is displayed: 



TCP/IP Installation Toof 3 * 




You have requested to install; 

> components of total size 17.79 
megabytes. If you are installing ovaR 
an existing version of the product^ ^ 
you will not need as much sgacx&T 
Only 0.00 megabytes remain on thi^ 
destination drive you have specifie&J 
Otherwise, you may want to specifT 
a different drive for the base 
^ directory. Do you want to continue' 



' | o: 







Figure 7. TCPIIP for OS/2 Installation 

Please ensure that you have adequate space for the installation to complete 
before continuing. This is particularly important when you are upgrading a 
previous version of TCP/IP for OS/2, because an incomplete installation will 
result in a mixture of the new and old versions of TCP/IP for OS/2. This 
mixture of code may be inoperable and prevent further attempts to install 
from an established server on this workstation. Consequently you may have 
to install from diskettes in order to complete the installation of TCP/IP V2.0 
for OS/2. 
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If you are not sure that there will be adequate space for TCP/IP V2.0 for 
OS/2, then click on Cancel to stop the installation process. You should then 
return to OS/2 and take actions to avail more disk space. 

If you are sure that there will be adequate space for TCP/IP V2.0 for OS/2, 
then click on OK to continue the installation process. 

8. You will be prompted to check the installation directory: 




9. If this is the wrong directory or drive for the installation then click on Cancel, 
so that you may start the installation process again. If this is the correct 
directory and drive for the installation, then click on OK, to continue with the 
installation. 

10. If you are upgrading a from a previous version of TCP/IP for OS/2, then you 
will be prompted to backup your etc directory: 
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Figure 9. ETC Directory Backup 



Click on OK, and continue. 

11. The next group of steps in the installation process involve the installation 
and configuration of LAN Adapter and Protocol Support (LAPS). This panel is 
displayed first: 
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Figure 10. LAN Adapter and Protocol Support (LAPS) 
Click on Install. 

12. You will be prompted for the Target Drive: 




Figure 1 1. Target Drive for LAPS 

Type the letter of the drive on which you want LAPS installed, and then click 
on OK. 

13. If LAN Adapter and Protocol Support is already installed, then this panel will 
be displayed: 




Figure 12. Reinstall LAPS 
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Figure 13. Reinstall LAPS 



In many cases, you will already have a version of LAPS installed, which is 
used by other IBM products such as IBM LAN Server V3.0 or 
Communications Manager/2 V1.0. Unlike previous versions of TCP/IP for 
OS/2, this installation of LAPS will preserve the configurations necessary for 
products already installed. This installation will ensure that you have the 
latest version of LAPS and TCP/IP drivers installed on your workstation. As a 
precaution, we recommend that you back up your CONFIG.SYS and IBMCOM 
directory before continuing with the installation (you can do this by switching 
to another OS/2 command prompt and copying these files to diskette. 

It is often difficult to distinguish the latest version of LAPS, you should 
carefully read all prompts to ensure that you use the latest version of LAPS 
on your CONFIG.SYS. 

Click on Yes to reinstall LAPS. A progress indicator will be displayed while 
the installation takes place: 




Figure 14. LAPS Installation Progress Indicator 

14. When the installation of LAPS is complete, this panel will be displayed: 




Figure 15. LAPS Installation Complete 

Please note, this is not the end of the installation. So far, only the LAPS 
program files have been copied to your system. Ahead, you must configure 
LAPS and install the rest of the TCP/IP V2.0 for OS/2 product. 

Click on OK. 

15. You will now be back to the LAN Adapter and Protocol Support menu. 
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Figure 16. LAPS Installation 

You need to configure LAPS for TCP/IP. Hence you must click on Configure, 
which will show this panel: 
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Figure 17. LAPS Configuration 



Select the Configure LAN Transports push button, and click on Continue. 

16. You will now be prompted to configure the workstation for LAPS. Select IBM 
TCP/IP from the Protocol Lists and Click on Add, so that it is included in your 
current configuration. Your configuration will then look like this: 
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Figure 18. Configure Workstation 

Click on OK to return to the LAPS Installation menu. 
17. You are now back at at the LAPS menu : 




Figure 19. LAPS Installation 
Click on Exit. 

18. You will now be prompted for the Drives to update CONFIG.SYS: 
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Figure 20. CONFIG.SYS Updates 



Click on Continue to make the changes to your CONFIG.SYS. 
Click on OK to acknowledge the changes to your CONFIG.SYS. 
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Figure 21. CONFIG. SYS Updated 

19. The Exiting LAPS panel will be displayed: 




Exiting"LAPS i 









The LAPS installation program has completed this pin 
processing successfully. To complete the process, yo 
' tnost perftmn ths followlng steps: Iff- 



mwm 

“‘WSaWK fljis inst^Ution/configi|raticm program^ 



m&jst. Stop' id guv naming psjrmiii. .. 

Shut dawn your system horn the OS /2 desktop. 

^ *,/ -ii&j ✓ ' . * ^ ' -A , , V tff - / 

;J :Wfen you restart your workstaKcm^ the LAPS 
automatically complete the changes' you have reques :l^§|§ 











Figure 22. Exiting LAPS 



Please ignore steps recommended in this panel. You must still go on to 
perform the rest of the installation of TCP/IP V2.0 for OS/2. Click on Exit. 

20. At last, each component of TCP/IP is installed, and the progress indicator 
will dynamically reflect the status of the installation: 
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Figure 23. TCP/IP Installation Progress Indicator 



21. When all components have been installed, this panel is displayed: 
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Figure 24. TCP/IP Installation Complete 

Click on OK, then shut down your machine and reboot. Your workstation is 
now equipped to use TCP/IP V2.0 for OS/2. 

2.3.2 Installation from a Code Server 

Your code server will contain the source files (obtained from the installation 
diskettes) for the installation. Workstations can access this code server via: 

• NetBIOS 

• NFS 

• IPX 

You should carefully consider the best platform to use for your code server. This 
will largely depend on what types of servers are already established on your 
network, for example: 

• OS/2 LAN Server V3.0 (NetBIOS) 

• TCP/IP V1.2.1 for OS/2 with Network File System Kit (NFS) 

• NetWare V3.11 (IPX) 
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If your workstations do not already have access to an established server then we 
recommend that you set up a code server with TCP/IP V2.0 for OS/2 and the 
Network File System Kit and use our bootable install method. 

2.3.2.1 Installation from an Established Server 

This section discusses the steps necessary to install TCP/IP for OS/2 from an 
established network drive. It describes the steps to be performed at the: 

• Code server 

• Workstations 

Note: For all remote installation scenarios of TCP/IP V2.0 for OS/2 we assume 
that OS/2 2.0 or 2.1 has already been installed. For a remote installation 
of OS/2, please refer to Network Transport Services/2 Redirected 
Installation and Configuration Guide, S96F-8488, or OS/2 2.0 Remote 
Installation and Maintenance, GG24-3780. 

At Your Server: You must load the product diskette images on the code server 
to the specified directory structure. This section provides instructions for loading 
the TCP/IP for OS/2 and the LAN Adapter and Protocol Support (LAPS) product 
diskette images on a code server. 

To load the diskette images, do the following: 

1. Create the following subdirectories on the code server: 

• \CID\IMG\TCPIP 

• \CID\RSP\TCPIP 

• \CID\LOG\TCPIP 

• \CID\IMG\LAPS 

• \CID\RSP\LAPS 

• \CID\LOG\LAPS 

2. Copy the LAPS diskette image to the \CID\IMG\LAPS subdirectory. 

Insert the LAPS diskette into your diskette drive and issue the following 
command: 

a:\lapsdisk a:\ d:\cid\img\laps 

Where a: is your diskette drive and d: is the target drive on the code server. 

3. Copy the TCP/IP for OS/2 diskettes to the server. 

a. Insert each diskette from the TCP/IP V2.0 for OS/2 package in the 
diskette drive and execute these commands: 

• copy a:*. zip d:\cid\img\tcpip 

• copy a:*XT.exe d:\cid\img\tcpip 

Note: Not every diskette may contain an *XT.exe file. 

b. Insert the first diskette of the base package in the diskette drive and 
execute these commands: 

• copy a:unzip.dll d:\cid\img\tcpip 

• copy a:tcpinst.exe d:\cid\img\tcpip 

• copy a:tcpinst.hlp d:\cid\img\tcpip 

• copy a:tcpinst2.exe d:\cid\img\tcpip 

c. Leave the first diskette of the base package in the the diskette drive and 
execute these commands: 
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• copy a:default.rsp d:\cid\rsp\tcpip 

• copy atlapsrsp.rsp d:\cid\rsp\laps 

Where a: is your diskette drive and d: is the target drive on the code server. 

4. Later you will be accessing the CID directories on the network server from a 
workstation, so you will need to ensure that security access to the directory 
on the network server is appropriately setup: 

Directory Access Permission Required 
\CID\IMG Read 
\CID\RSP Read 
\CID\LOG Read, Write 

At Your Workstation 

1. Execute network commands on the workstation to access the CID directory 
on the network server. Listed below are some examples for some popular 
and supported network servers required for TCP/IP 1.2.1 for OS/2 
components. 



Table 6. Network Commands to Access a Code Server 


Server 


Command 


LAN Server 


Net use x: \\servername\netname 


NetWare 


Map x: — servername/volumename:path 


NFS 


Mount x: hostname:mountname 



Where x: is the drive being assigned to the CID directory on the code server 
and d: is the source drive on the code server, for example: 

LAN Server 3.6 OS/2 LAN Requester 

CID=D:\CID NET USE X: \\server\CID 

NetWare 3.11 Server OS/2 NetWare Requester 

SYS: PUBLIC\CID MAP X:=server/SYS:PUBLIC\CIO 

TCP/IP OS/2 NFS Server OS/2 NFS Client 

D:\CID MOUNT X: server:D:\CID 

TCP/IP AIX NFS Server OS/2 NFS Client 

/u/cid MOUNT X: server:/u/cid 

2. Ensure that you have set your hostname. If you are using TCP/IP and NFS to 
access the code server, then it will already be set. Otherwise, enter the 
following at an OS/2 command prompt: 

set hostname=host_name 

where host_name is the unique name assigned to your workstation. 

3. At an OS/2 prompt, access the \IMG\TCPIP subdirectory of the remote drive 
(X:). We recommend that you type the command with these parameters: 

tcpinst /r:x:\rsp\tcpip\default.rsp /s:x:\img\tcpip 
/t: c:\tcpip /lp: x:\img\laps 

and press Enter, where x: is the drive assigned to the CID directory on the 
code server and c: is the drive on which TCP/IP V2.0 for OS/2 is being 
installed. 
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We found that these parameters were necessary to start the installation 
process. You are prompted for most other parameters after the installation 
has started. 

This installation process will now resemble the installation from diskettes 
except you will not be prompted to insert the installation diskettes. Instead, 
the files will be copied directly from your established server onto the fixed 
disk drive of the workstation being installed. We recommend that you follow 
steps 4 and onwards described in the installation from diskettes section, in 
order to complete the installation. 

2.3.2.2 Installation using Bootable Install Diskettes 

This section describes the steps to create a code server that can be used to 

install TCP/IP from bootable diskettes. 

At Your Server 

1. Install TCP/IP from diskettes using the steps described in 2.3.1, “Installation 
from Diskettes" on page 18. 

2. Set up the system as a code server using the steps described in 2.3.2.1, 
“Installation from an Established Server” on page 27. 

3. Please ensure that you have enabled NFS access to the C.I.D. directories on 
this code server. You can do this by: 

a. Starting the TCP/IP configuration notebook. 

b. Clicking on the NFS tab of the notebook. 

c. Clicking on the right arrow at the bottom right hand corner of the page. 
Your panel should look like Figure 25 on page 30. 
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Figure 25. TCPIIP Configuration (NFS) 

Click on Add, in order to add a directory your exports list. 
4. Type in the: 

• Directory 

• Access authority 

• Clients 

• Comment 

Your panel should look like Figure 26. 




Figure 26. Exports Entry - Add 
Click on Add 



30 TCP/IP V2.0 for OS/2 







5. Your TCP/IP configuration panel has been updated: 




Figure 27. TCP/IP Configuration (NFS) 



6. You need to configure the NFS server to start as a service with TCP/IP. Click 
on the Autostart tab. Then click on the right arrow at the bottom of the page 
once. Select Enable this machine to function as an NFS Server. Your panel 
should look like this: 
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Figure 28. TCP/IP Configuration (Autostart) 



7 . Close the configuration menu by double clicking on the top left-hand corner 
of the window. 

Note: Since the NFS server requires the Portmapper to be started, the 
configuration program will also configure Portmap to start 
automatically, and it will inform you of this by showing a message 
box. 




■; Glosing^tiGB/II^I 



Elect s arid'saveaU 

^ *&&&$& x*;? ^ .,r. > .? a . <:/ 

Select Discard tootose the notebook WITHOUT saving AHY changes to bar 

'If ' ~ : % //' / '* S'* <■' , V :'-v- 




Figure 29. Closing TCP/IP Configuration 



Click on Save. This system is now set up to permit other workstations to 
access the directories containing the TCP/IP files used for installation using 
CID. 
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Preparing Bootable Diskettes: This section describes the steps to be performed 
in order to create bootable diskettes using MAKENFS. This file is provided with 
TCP/IP V2.0 for OS/2 and is located in the BIN subdirectory. The entire process 
(including how to use NFS) is as follows: 

1. Make copies of the first two diskettes supplied with OS/2 V2.1. 

You should use the OS/2 SEDISK and SEIMAGE commands as described in 
the TCP/IP V2.0 for OS/2 Installation and Administration Guide . 

This will require about 32MB disk space at the server and about two hours' 
time to complete, though all you need from that is a copy of the OS/2 
diskette 1. 

To copy the SEIMAGE and SEDISK commands to your server, insert the OS/2 
diskette 7 into drive A: and enter: 

unpack a:cid 

Then run SEIMAGE to copy all OS/2 diskette images to the server, then run 
SEDISK to create bootable OS/2 diskettes. See the TCP/IP V2.0 for OS/2 
Installation and Administration Guide for more information. 

We tried several techniques to shortcut the SEIMAGE process, but 
unfortunately it is necessary to create images of all diskettes so that SEIDISK 
can produce genuine OS/2 diskette 1. does the job, and it takes much less 
time and disk space. 

2. Manually preparing bootable diskettes. 

You will use the first diskette, unmodified, as the Initial boot diskette 
(hereafter referred to as the NFS boot diskette 0). 

3. Insert the second OS/2 diskette (hereafter referred to as the NFS boot 
diskette 1) into your diskette drive, type: 

erase a:\bundle 

and press Enter. 

This file is not needed for the bootable installation process, and by removing 
it from the diskette you will ensure adequate space for the NFS files. 

Then, you should type: 
makenfs 

and press Enter. 

4. MAKENFS prompts you for the following information: 

• The full path name of your NTS2 base directory. This is the base 
directory of the server that contains your network adapter driver. 

Warning: A PROTOCOL.INI is installed on the diskette which is based on 
your PROTOCOL.INI. It assumes that you want to use the same type of 
network adapter and address. You should ensure that the PROTOCOL.INI 
is compatible with the workstations on which you plan to use the 
bootable installation diskettes. You should also ensure that you use an 
universal address to avoid incidents of duplicate addresses on the local 
area network. 

• The full path name of your TCP/IP base directory. This is the base 
directory of the server that contains the version of TCP/IP that the server 
is running, not the directory that contains the TCP/IP for OS/2 diskette 
images. 
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• The full path name of your NFS base directory. The default is the path 
that you entered previously for the TCP/IP base directory. 

• The full path name of your OS/2 base directory. This is the base 
directory of the server that contains OS/2. 

After you have answered these questions, MAKENFS begins loading the 
appropriate files to the NFS boot diskette 1. 

5. MAKENFS then prompts you to insert the NFS boot diskette 2 in the diskette 
drive. Insert a blank, formatted 2.0MB diskette and press Enter. 

MAKENFS continues loading the remaining files and displays a message 
when all files have been loaded. 

6. Edit the CONFIG.SYS file on the NFS boot diskette 1. Ensure that these 
variables are set correctly: 

set os2shelKMD.EXE (Default is SYSINST2.EXE) 

set CID_TRANSPORT=NFS 

set mount_string=x: cidserver: d:\cid 

set rsp_path=x:\rsp\tcpip 

set laps_exe_path=x:\img\laps 

set ETC=A:\ETC 

7. We suggest that you also copy the following files from the \TCPIP\BIN 
directory to the NFS boot diskette 2: 

• PING.EXE 

• NETSTAT.EXE 

• ARP.EXE 

• QMOUNT.EXE 

• SHOWEXP.EXE 

These utilities will help you find out what is wrong in case of problems with 
mounting the code server. 

8. Prepare a response file for TCP/IP and for LAPS for each workstation that 
you are going to install. 

The more information you provide with a response file, the less information 
is required to be entered at a workstation. If you want the installation to be 
nearly unattended (just changing of the diskettes is required), then provide 
all information in the response files and in the CONFIG.SYS file of the NFS 
boot diskette 1 of each workstation. See the TCP/IP V2.0 for OS/2 Installation 
and Administration guide for more details on these parameters. 

At The Workstation : This section describes the steps to be performed at the 
workstation in order to install TCP/IP from bootable diskettes. 

To install TCP/IP for OS/2 from bootable diskettes, do the following: 

1. If you already have a version of LAPS installed, for instance with IBM OS/2 
LAN Server V3.0 or IBM Communications Manager/2 VI. 0, make a copy of 
your CONFIG.SYS and \IBMCOM\PROTOCOL.INI files. 

2. Insert the NFS boot diskette 0 into your diskette drive. 

3. Restart your system. 

— Warning — 

When boot diskette 0 has completed loading, you are asked to insert the 
Operating System/2 diskette 1 into drive A. DO NOT DO THIS. 
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4. Remove the NFS boot diskette 0, insert the NFS boot diskette 1 into your 
diskette drive, and press Enter. 

The OS/2 logo appears and the following message is displayed: 

Loading, please wait.... 

Please do not write-protect the NFS boot diskette 1 since LAPS will attempt 
to write a LANTRAN.LOG file. 

5. When all drive activity has stopped you should see the [A:\] prompt. 
Remove the NFS boot diskette 1 from your diskette drive and insert the NFS 
boot diskette 2 into your diskette drive. 

6. Type: 

tcpinst2 
and press Enter. 

7. Type in your: 

• Hostname 

• IP address 

• Netmask 

• Router Address 

Your panel should look similar to Figure 30. 



\ 

TCP/IP Installation Status 

Configuring NFS... 

Configure NFS for Remote Install 

IP address : 9.67.38.166 Subnet mask: 255.255.255.192 
Router IP address: 9.67.38.75 
Hostname: miers 

Boot drive: C: 

Source path: X:\IMG\TCPIP\ 

Parameters to MOUNT: x: cidserver:d:\cid 

F10 - Install Esc - Cancel 

/ 

Figure 30. TCPINST2 Configure NFS. 

Press Enter. 

8. Ensure that you have typed the correct information and select the kits that 
you need to install: 
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Install TCP/IP 2.0 for OS/2 



Base directory: c:\tcpip 
[Y] Update CONFIG.SYS 

[Y] Install /Run LAN Adapter and Protocol Support 

— LAN 6 Configuration 

[Y] Configure LAN 0 

Hostname: miers Subnet mask: 255.255.255.192 

IP address: 9.67.38.106 Router IP: 9.67.38.75 



— Kit Installation 

[Y] Base TCP/IP for [N] NFS TCPIP CIO I [N] PMX Kit 

[Y] Pubs for Base T [N] DOS Box Kit [N] X-Client Runtim 

[N] LaMail [N] WINSOCK Oocumen [N] X-Client Progra 

[N] IBM Library Rea [N] Extended Networ [N] Domain Name Ser 

[N] NFS Kit [N] Programmer 1 s To 



F10 - Install Esc - Cancel 
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Figure 31. TCPINST2 Install. 

Note: The keyboard layout at this time is US, so be careful to hit the proper 
key if you want to enter a Y and you have a non-US keyboard. 

9. Press FIO to start the installation. 

The status of the installation is shown, while it takes place: 



TCP/IP Installation Status 



Installing Selected Kits... 
Installing DOS Box Kit 

— Progress 

c : \tcpi p\bi n\vdostcp . vdd 
c : \tcpi p\bi n\vdebug . exe 
c:\tcpip\bin\vdostcp.sys 
C:\LANLK\00000O 
c : \tcp i p\dos\bi n\pi ng . exe 
c:\tcpip\dos\bin\wping.exe 
c : \tcpi p\dos\bi n\wi nsock.dl 1 
c:\tcpip\dos\bin\tcpcntl .exe 



V J 

Figure 32. TCPINST2 Installation Status. 

10. The installation process will highlight whether you must create a folder for 
TCP/IP using the TCPDSKTP command after you reboot the machine . 

11. Press Enter to complete the installation process when this panel is shown on 
the screen: 
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TCP/IP Installation Status 



Creating 



Progr 

C:\LANLK 
c:\tcpip 
c:\tcpip 
c:\tcpip 
c:\tcpip 
c:\tcpip 
c:\tcpip 
c:\tcpip 
c : \tcpi p\bi n\dskdbox . tcp 
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Installation Complete 



Installation completed successfully. 
Please shutdown your system and 
reboot for TCP/IP. After rebooting, 
you will find a TCP/IP Configuration 
folder in the TCP/IP folder on your 
desktop. Select the TCP/IP 
Configuration folder to configure 
TCP/IP. 

OK 



Figure 33. TCPINST2 Installation Complete. 

12. Reboot the computer. 

13. The installation process does not update your OS/2 Workplace Shell desktop 
when using bootable installation diskettes. So you must run this command 
from an OS/2 command prompt: 

TCPDSKTP.EXE 

Press Enter. 

14. If you receive LAN error messages when booting, then your CONFIG.SYS is 
not compatible with your PROTOCOL.INI. Type this command from an OS/2 
command prompt: 

UPS 

Press Enter. Then follow steps 10 to 17 in 2.3.1, “Installation from Diskettes” 
on page 18. If you are an experienced user of LAPS, you can also manually 
merge your old and new CONFIG.SYS and PROTOCOL.INI files. 

2.3.2.3 Configuration Files for Bootable Diskettes 

The following example lists the response files and the CONFIG.SYS file of an NFS 
boot diskette 1 that we used to remotely install TCP/IP V2.0 for OS/2: 

DEFAULT.RSP (server) 

// Default response file for PRODUCT DISK install 

INSTALLJAME = BASE 7.39 14 "Base Kit" Base TCP/IP for OS/2 

INSTALLJAME = BPUBS 1.40 5 5 "Base Kit" Pubs for Base TCP/IP for OS/2 

INSTALLJAME = LAMA I L 1.90 6 6 "Base Kit" LaMail 

INSTALLJAME = ILR 1.32 1 1 "IBM Library Reader" IBM Library Reader 

// INSTALL NAME = APPS 6.75 1 4 "Applications Kit" Applications Kit 

// IN$TALL~NAME = BPUBS 1.40 5 5 "Applications Kit" Pubs for Base TCP/IP for OS/2 

// INSTALLJAME = LAMAIL 1.90 6 6 "Applications Kit" LaMail 

INSTALL NAME = NFS 1.10 1 1 "Network File System Kit" NFS Kit 

INSTALLJAME = NFSCID 0.25 1 1 "Network File System Kit" NFS TCPIP CID Install 

INSTALLJAME = DBOX 0.56 1 1 "DOS/Windows Access Kit" DOS Box Kit 

INSTALLJAME = WSOK 2.00 1 1 "DOS/Windows Access Kit" WINSOCK Documentation 
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INSTALLJAME = XNT 0.96 1 1 "Extended Networking Kit" Extended Networking Kit 
INSTALL NAME = PGMG 0.85 1 1 "Programmer's Toolkit" Programmer's ToolKit 
INSTALLJAME = PMX 11.36 1 6 "X Window System Server Kit" PMX Kit 
INSTALLJAME = XCLI 2.38 1 2 "X Window System Client Kit" X-Client Runtime Services 
INSTALLJAME = XCPR 1.44 1 1 "X Window System Client Kit" X-Client Programmer's Toolk 
// INSTALLJAME = MOTIF 1.49 1 1 "OSF/Motif Kit" OSF/Motif Runtime Services 
// INSTALLJAME = MTPR 0.80 1 1 "OSF/Motif Kit" OSF/Motif Programmer's Toolkit 
INSTALLJAME = DNS 0.75 1 1 "Domain Name Server Kit" Domain Name Server Kit 

EXEC = BASE call basext BOOTJRIVE TARGET JATH MPTNJNSTALLED NTS2 DIR 
HOSTNAME IP_ADDR NETMASK ROUTE DNSDOMAIN NAMESERVER 
EXEC = NFS call nfsxt BOOTJRIVE TARGET JATH 
EXEC = DBOX call dboxxt BOOTJRIVE TARGET PATH 
EXEC = PMX call pmxxt BOOTJRIVE TARGET JATH HOSTNAME 
EXEC = PGMG call ptkxt BOOT DRIVE TARGET PATH 
EXEC = XCPR call xcprxt BOOTJRIVE TARGET JATH 
EXEC = XCLI call xclixt BOOTJRIVE TARGET JATH ETC JATH 

HPFSJEEDED = XCPR XCLI 

LAPSRSP.RSP ( server ) 



INSTJECTION = ( 
INSTALL = product 
UPGRADEJEVEL = new 
) 



PROTOCOL = ( 

[PROTJAN] 

DRIVERNAME = PR0TMAN$ 
[IBMLXCFG] 

IBMTOKmf = IBMTOK.nif 
TCPIP_nif = TCPIP.nif 



[TCPIPjif] 

DriverName = TCPIP$ 
Bindings = IBMTOKnif 

[IBMTOK_nif] 



DriverName = IBMT0K$ 
ADAPTER = "PRIMARY" 
MAXTRANSMITS ■= 6 
RECVBUFS = 2 
RECVBUFSIZE = 256 
XMITBUFS = 1 



) 

CONFIG.SYS ( diskette ) 
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buffers=32 

iopl=yes 

memman=noswap 

protshel 1 =sysi nstl.exe 

set os2_she11=cmd.exe 

diskcache=64,LW 

protectonly=yes 

1 i bpath=. ;\;\os2\dl 1 ; 

ifs=hpfs.ifs /c:64 

pauseonerror=no 

codepage=850 

country=044,country.sys 

devi nfo=kbd , uk 166 , keyboard . dcp 

devi nfo=scr,ega,vtbl 850. dcp 

device=\dos.sys 

device=\mouse.sys 

set path=\;\os2;\os2\system;\os2\instal 1 

set dpath=\;\os 25 \os 2 \system;\os 2 \i nstal 1 

set keys=on 

basedev=pri nt0 1 . sys 

basede v=i bmlf 1 py . add 

basedev=ibmls506.add 

basedev=ibm2flpy.add 

basedev=i bm2ads k . add 

basedev=i bm2m57.add 

basedev=i bm2scsi . add 

basedev=ibmintl3.il3 

basedev=os2dasd . dmd 

devi ce=\testcfg . sys 

set cid_transport=nfs 

set mount_string=x: fawpsltl :g:\cid 

set rsp_path=x:\rsp\tcpip 

set laps_exe_path=x:\irng\laps 

set etc=a:\etc 

SET TMP=A:\ 

DEVICE=A:\LANMSGDD.0S2 /I:A:\ 

DEVICE=A:\PROTMAN. 0S2 /I:A:\ 

DEVICE=IBMT0K.0S2 

DEVICE=INET.SYS 

DEVICE=IFNDIS.SYS 

CALL=A: \NETBIND.EXE 

RUN=A: \LANMSGEX . EXE 

RUN=A:\CNTRL.EXE 

IFS=A:\NFS200.IFS 



2.4 Configuration of the Base Kit 

1. Once you have installed TCP/IP V2.0 for OS/2, you will have a folder on your 
desktop called TCP/IP. If there is no folder then you should run this 
command from an OS/2 command prompt: 

C:\TCPIP\BIN\TCPDSKTP 

Where C: is the name of the drive on which TCP/IP V2.0 for OS/2 is installed. 
Open the TCP/IP folder. 
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Figure 34. TCP/IP Folder 

2. You can configure TCP/IP V2.0 for OS/2 using the TCP/IP Configuration 
Notebook. You can start the TCP/IP Configuration Notebook by typing this 
command from an OS/2 command prompt: 

TCPIPCFG.EXE 

Otherwise you may double click on TCP/IP Configuration from the TCP/IP 
folder. 

3. Configure your IP information for this interface: 

Parameter Description 

IP Address The IP address of this interface to the IP network 

Subnet Mask This is the value adopted by your network coordinator 

to define the range of your IP address. 

Routing Metric Count The number of hops that can be used to access 
another IP address. 
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Figure 35. Network Interface 0 

4. Click on the Routing tab. Configure your routing table entries: 
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Figure 36. Routing 



This page is used to define any routers that will be used to address systems 
on another network. The following is the information required on this page of 
the notebook: 

Parameter Description 

Route Type Specify the type of route for a destination: 

a. net 

b. subnet 

c. host 

d. default 



Destination 



Router 

Metric 



The IP address that you would like to access. 

This will be a network address for route type 
SUBNET, and a host address for route type HOST. 

The IP address of the machine which will be able 
to route information to the destination IP address. 

The number of hops to the destination IP 
address. 



5. Select any services that should be started automatically with the Base 
TCP/IP services. In addition, you can select from the following: 

a. Start a service as a subservice of a single server (INETD) 

b. Start a service as a foreground task 

c. Minimize a service to your desktop upon starting (foreground only) 

d. Specify additional startup parameters for a service (foreground only) 
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f/gure 37. Autostart - Page 1 




Click on the right arrow in the bottom right-hand corner of the panel. Select 
any services which should be started automatically with the Base TCP/IP 
services: 
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Figure 38. Autostart - Page 2 



Click on the right arrow in the bottom right-hand corner of the panel. Select 
any services which should be automatically with the Base TCP/IP services: 
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Figure 39. Autostart - Page 3 



Click on the right arrow in the bottom right-hand corner of the panel. Select 
any services which should be started automatically with the Base TCP/IP 



services: 




Figure 40. Autostart - Page 4 

6. Click on the Services tab. Configure your Domain Name Services 
information: 
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Figure 41. Services - Page 1 

The information required on this page of the notebook includes: 

Parameter Description 

CODEPAGE The International CODEPAGE used by TCP/IP. 

This will tailor keyboard functions for 
International Standards. 

TRUSERS A list of users that can remotely access this 

machine using FTP. 

This machines Hostname The Hostname of this machine 
Domain Name The name of this domain 

Domain Nameserver The IP Address of the Domain Nameserver 

Click on the right arrow in the bottom right-hand corner of the panel. 

7. Configure your PINGHOST, LPR and REXEC information: 
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Figure 42. Services • Page 2 

The information required on this page of the notebook includes: 

Parameter Description 

PINGHOST.LST A list of addresses that you PING from the 

PMPING program. 

Remote Print Server Hostname or IP address of an LPD server 

Remote Print Server's Printer Device name at the LPD server 

Maximum number of LPD Ports Number of LPD Ports to use with the OS/2 

Workplace Shell 

Username for REXEC & Remote Printing Name that you use with these 

services 

Password for REXEC Users Password that users have to specify to use the 

REXECD server at your workstation. 

Click on the right arrow in the bottom right-hand corner of the panel. 

8. Configure your TELNET, HOSTS and RHOSTS information: 
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Figure 43. Services - Page 3 

This is an explanation of the information required on this page of the 
notebook: 

Parameter Description 

Telnet Password Password required by users to establish a Telnet 

session with this machine. 

The hostname or address of the server normally 
accessed when using NewsReader/2. 

A list of addresses and hostnames. It is used by 
TCP/IP services like TELNET and FTP to resolve 
an IP address from a hostname. For example, it 
will resolve CIDSERVER to address 9.67.38.115. It 
is only used after a Domain Name Server has 
failed to resolve an address or when you do not 
use a Domain Name Server, 

RHOSTS A list of hostnames that are authorized to use 

RSH server functions on this machine. 

9. Close the TCP/IP Configuration Notebook by double clicking in the top 

right-hand corner of the window. Select Save to close the notebook and save 
all changes to your configuration on the hard disk: 



NewsReader/2 Server 
HOSTS 
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Figure 44. Closing TCP/IP Configuration 

This is a list of the files that can be created, updated, or modified by the 
TCP/IP Configuration Notebook: 



Table 7. TCP/IP Configuration Files Modified by the TCP/IP Configuration Notebook 


CONFIG.SYS (OS/2) 


RHOSTS (RSH) 


PMX.INI (PMX) 


SETUP.CMD (Base) 


NR2.CTL (NR2) 


XOHOSTS (PMX) 


TCPSTART.CMD (Base) 


SENDMAILCF (SENDMAIL) 


X25.CMD (X.25) 


RESOLV (Base) 


MIB2.TBL (SNMPD) 


X25DIR (X.25) 


HOSTS (Base) 


SNMPTRAP.DST (SNMPD) 


X25RTE (X.25) 


TRUSERS (FTP) 


PW.SRC (SNMPD) 


X25IP (X.25) 


PINGHOSTS.LST (PMPING) 


EXPORTS (NFSD) 


SNALIP.CFG (SNALINK) 


INETD.LST (INETD) 


FSTAB (NFSC) 


SLIP.CFG (SUP) 



10. Click on OK to make the necessary changes to your CONFIG.SYS: 




Figure 45. Changing CONFIG.SYS Panel 

We have included the relevant statements of an example CONFIG.SYS from a 
workstation installed with TCP/IP V2.0 for OS/2 and updated by this panel 
(we have manually added the REM statements): 

REM The directory that contains many of the information files 
REM necessary to start TCP/IP services. For example it contains 
REM files read at startup by SNALIO.EXE (SNALINK) and NFSD.EXE (NFS 
REM Server) 

SET ETC=C:\TCPIP\ETC 
SET TMP=C:\TCPIP\TMP 

REM The directory where TCP/IP information and document files reside. 
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REM These files are used by IBM BookManager and OS/2 VIEW.EXE 
SET READIBM=C:\TCPIP\DOC 

REM The hostname by which this workstation is identified. For example 
REM when a remote user tries to initiate a telnet session with your 
REM machine, this hostname is shown on the logon screen as the name of 
REM the machine. 

SET HOSTNAME=mi ers 
RUN=C:\TCPIP\BIN\CNTRL. EXE 

REM This is the Installable File System driver, so that you can mount 
REM NFS drives on your workstation. 

IFS=C:\TCPIP\BIN\NFS200. IFS 

REM The Virtual device drivers necessary for DOS applications to 
REM access the TCP/IP transport layer provided by TCP/IP for OS/2 
DEV I CE=C:\TCPI P\BI N\VD0ST CP . VDD 
DEV I CE=C:\TCPI P\BI N\VD0STCP . SYS 
RUN=C:\TCPIP\BIN\VDOSCTL.EXE 

REM API library files used with the Application Programmers kit to 
REM develop TCP/IP applications. 

SET LIB=C:\TCPIP\LIB 

REM API header files used with the Application Programmers kit to 
REM develop TCP/IP applications. 

SET I NCLUDE=C:\TCPI P\I NCLUDE 

REM The default display used by X Windows Client applications 

SET DISPLAY=mi ers:0 

REM X Client Windows Files 

SET XFI LES=C : \TCPI P\X 11 

REM Timezone for stamping files on NFS mounted drives correctly 

SET TZ=est5edt 

REM NFS parameters 

SET NFS. PERMISSION. BITS=700 

SET NFS. PERMISSION. DBITS=700 

REM Password required by users to start a TELNET session with this 
REM machine. 

SET TELNET. PASSWORD. ID=si ngsong 

REM The name of the NEWSSERVER normally used by NewsReader/2 

SET NEWSSERVER=hawnews . watson . i bm. com 

REM Files used by X Client applications 

SET XFILESEARCHPATH=c:\tcpip\Xll 

SET XAPPLRESDIR=c:\tcpip\Xll 

SET XENVIRONMENT=c:\tcpi p\ETC\Xresource 

SET XKEYSYMDB=c:\tcpip\XKeysymDB 



2.5 Connecting TCP/IP V2.0 for OS/2 to a Serial Line Using SUP 

One of the communication interfaces that TCP/IP V2.0 for OS/2 can be connected 
to is a serial line, using the Serial Line Internet Protocol (SLIP), it can be 
established using either of the following: 

1. A modem to connect two workstations via a telephone network 

2. A null-modem cable to connect two workstations back to back. 

The serial line interface that you are using has to be attached to one of your 
workstation's serial ports (COM1 through COM4 are supported by OS/2). 

SLIP with TCP/IP V2.0 for OS/2 has the following prerequisites: 

• DEVICE°COM.SYS statement in the CONFIG.SYS file 

• OS/2 REXX support must be installed when using attachment scripts. 
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SLIP with TCP/IP V2.0 for OS/2 has the following limitations: 

• Only one serial line connection can be established at a time 

• Loopback on SLIP is not supported (you cannot ping yourself) 

• Only one attachment script can be run during SLIP startup. 

The following figure shows how TCP/IP V2.0 for OS/2 uses a serial interface: 




♦ 



♦ 



COM Port 



IFNDIS.SYS 



NDIS Protocol Manager 



LAN Hardware 



Modem 



Figure 46. COM Port usage by TCP/IP V2.0 for OS/2 



Apart from merely connecting to a serial line interface, TCP/IP V2.0 for OS/2 
provides the following features for SLIP: 



VJ compression Compresses headers of IP packets 

Attachment scripts Automate establishment of SLIP connections by virtue of 
REXX command files to set COM port and TCP/IP interface 
parameters, and send modem commands 



SLIPTERM Send interactive commands to a modem 

IFNDISNL Null driver to be used without a LAN (see note below). 



Note: If the serial line is the only interface that you want to use with TCP/IP V2.0 
for OS/2, you can substitute the IFNDIS.SYS device driver with the 
IFNDISNL.SYS driver which is located in the \TCPIP\BIN subdirectory. 

The appropriate statements in the CONFIG.SYS file should then read: 

DEVI CE=d : \0S2\C0M . SYS 
DEVICE=d:\TCPIP\BIN\INET.SYS 
DEVICE=d:\TCPIP\BIN\IFNDISNL.SYS 
RUN=d:\TCPIP\BIN\CNTRL.EXE 

where d: refers to the drive where OS/2 and TCP/IP are installed. 



In that case you do not need to install LAPS. Do not check the Configure 
network connection and Install LAPS options on the TCP/IP installation 
menu. When you are prompted to insert the LAPS diskette, do so to 
maintain the order of diskettes for the installation procedure. LAPS will 
not be installed, though. 

The TCP/IP Configuration Notebook will modify the SLIP.CFG and SETUP.CMD 
files during SLIP interface customization, which is shown in the following figure: 
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Figure 47. Configure The SLIP Interface 



Setting Meaning 

Enable the SLIP interface Check this option if you want to use the serial line 

connection 

Communications Port Specify the serial port on your workstation to be 

used by SLIP 

VJ Compression Specify whether you want to use compression of IP 

headers 

Maximum Transmission Unit Specify the maximum transmission unit for the 

SLIP interface 

Script File Specify an attachment script to set up the SLIP 

interface 

Script Attachment Parameters Specify additional parameters for the attachment 

script 

IP Address Specify the IP address of the SLIP interface at your 

workstation 

Destination Address Specify the IP address at the remote side of the 

serial line (SLIP only esablishes a point-to-point 
link). 



The above configuration creates a \TCPIP\ETC\SLIP.CFG file which is read 
during initialization of the SLIP interface. That is performed by the SLIP and 
IFCONFIG commands placed in the \TCPIP\BIN\SETUP.CMD file, as shown in the 
following example for host martin: 

start slip.exe 
si i pwai t 

ifconfig slO 9.67.46.1 9.67.46.2 netmask 255.255.255.192 

If you specify an attachment script it will be executed by SLIP.EXE, eventually 
using parameters that you specified in the Configuration Notebook, or in the 
SLIP.CFG file. The SLIPWAIT command causes SETUP.CMD to wait for SLIP.EXE 
to finish setting up the serial line interface before IFCONFIG gets executed. 
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In order to prepare a serial port for use by SLIP.EXE you need to run the OS/2 
MODE command, or use an attachment script. That will set parameters such as 
line speed, data bits, and parity according to your particular requirements. 








In order to initialize a modem, run SLIPTERM for manual connection, or use an 
attachment script. 

2.5.1 Manually Establishing a SLIP Connection 

The following example shows a setup for 19200bps, no parity, 8 data bits, 1 stop 
bit, and using data buffering on the COM port (if supported): 

MODE COM 1 , 192 , n , 8 , 1 , buf f er=on 

To make sure that a serial port is set up correctly, insert the MODE command 
into the SETUP.CMD file, just before the SLIP.EXE statement: 



MODE COMn, baud, parity, data, stop, optional parameters 

START SLIP.EXE 

SLIPWAIT 

IFCONFIG slO local -IP-addr remote- I P-addr optional -parameters 



The following example will result in a successful SLIP connection between hosts 
martin and miers: 

• Calling workstation (martin) 

1. MODE coml,192,n,8,l,buffer=on 

2. START SLIP.EXE 

3. SLIPWAIT 

4. Run SLIPTERM to send the call command and telephone number to your 
modem, for instance: 




Skip this step when using a null-modem cable. 

5. ARP -f 

6. IFCONFIG slO 9.67.46.1 9.67.46.2 netmask 255.255.255.192 

7. ROUTE -fh default 9.67.46.2 

• Called workstation (miers) 

1. MODE coml,192,n,8,l,buffer=on 

2. START SLIP.EXE 

3. SLIPWAIT 

4. Run SLIPTERM to set your modem into auto-answer mode, for instance: 
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5. 

6 . 

7. 

Note: SUP must be running before SLIPTERM can be used. 

2.5.2 Using Attachment Scripts to Establish a SLIP Connection 

TCP/IP V2.0 for OS/2 supplies the following attachment scripts as examples: 
AUTOANS.CMD For workstations being dialled to 
FONUSER.CMD For dialling workstations requiring no password 
SLIPUP.CMD For dialling workstations requiring a password. 

The following sequence should result in a successful SLIP connection: 

• Calling workstation 

1. Create or modify script file to: 

- Set up COM port 

— Initialize modem 
— Dial out 

— Set TCP/IP parameters 

2. Start SLIP.EXE 

• Called workstation 

1. Create or modify script file to: 

— Set up COM port 

— Initialize modem 
— Set modem into auto-answer mode 
— Set TCP/IP parameters 

2. Start SLIP.EXE 

2.5.3 Using Serial Line IP 

The following tasks will be running when SLIP has been initialized: 



r — 

[C:\tcpip\bin]sl ipterm 


N 


1 SUPTERM 
+ — 


- TCP/IP Version 2.9 (using C0M1) | 






1 Action | 




& 


| Successful exit (continues TCP/IP setup) | 
I Unsuccessful exit (aborts TCP/IP setup) j 
| Sent to COM port unchanged. j 




[ Requesting COM port access from SLIP driver ] 
[ SLIP driver granted access ] 

[ Startup Complete ] 




ATA 






^ [C:\tcpip\bin] 


J 



Skip this step when using a null-modem cable. 

ARP -f 

IFCONFIG si 0 9.67.46.2 9.67.46.1 netmask 255.255.255.192 
ROUTE -fh default 9.67.46.1 
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SL/IP 

i.e 



OS/2 TCP/IP SLIP Driver 



[MON ] SLIP Driver Running. Exit with Ctrl-C or Ctrl-Break 



Use the Ctrl-C keys to terminate SLIP. 

To verify whether a SUP connection is operating, do the following: 

• Use the NETSTAT -a command to see if your local SLIP interface has been 
initialized 

• Use the IFCONFIG sl0 command to see if the SLIP interface is up 

• Try to PING the remote address. 

When you want to use NFS on a SLIP connection, set up the NFS client to 

1. Use a buffersize of 512 bytes (-b option) 

2. Disable the use of biods (-s option) 

3. Eventually increase the RPC timeout value (-t option) 
as shown in the following example: 

NFSSTART -b512 -t5 -S0 

Note: The NFS server does not start when you use the IFNDISNL null driver. 

Please see the TCP/IP V2.0 for OS/2 Installation and Administration manual for 
more information on SLIP. 
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Chapter 3. Remote Logon 



This chapter describes the facilities available with the TCP/IP V2.0 for OS/2 
product to remotely log on to and emulate terminals on other systems on the 
network. 

TCP/IP V2.0 for OS/2 features both a Telnet server to allow other systems to 
access OS/2, and Telnet clients to access other systems from OS/2. 

This chapter introduces the integration of Telnet clients into the OS/2 Workplace 
Shell, and it also discusses some of the customization requirements for the 
Telnet server. 

The test environment for this chapter are shown in 1.4, “ITSC Raleigh Test 
Environments” on page 11. 



3.1 TCP/IP V2.0 for OS/2 Telnet Server 

The Telnet server uses Dynamic Link Library (DLL) files to implement the 
supported terminal types. You must specify the path where the DLL files that are 
used with Telnet reside. This path is specified using the LIBPATH statement in 
your CONFIG.SYS file. Usually, the installation program takes care of this. 

The DLL files are: 

• VT100.DLL 

• ANSI.DLL 

• DUMB.DLL 

To use the TCP/IP V2.0 for OS/2 Telnet server, you must configure a password 
for a Telnet client user to specify during logon. If a password is not defined, the 
Telnet client user has no access to the server. 

The Telnet server uses the environment variable TELNET.PASSWORD.ID as the 
logon password for connecting Telnet clients. However, this environment 
variable should not be specified in the CONFIG.SYS file because each user who 
has access to your CONFIG.SYS can remotely login to your Telnet server. There 
are no restrictions on what a remote client can do after logging on to your 
workstation. One way to store this variable is to set it in a .CMD file which starts 
the Telnet server. 

For example, the following TELNET.CMD file starts the Telnet server and sets the 
TELNET.PASSWORD.ID variable to the password "secret": 

SET TELNET. PASSWORD. ID=secret 
TELNETD -1 > TELNETD.LOG 

The -1 parameter tells the Telnet server to log all client connections in the 
TELNETD.LOG file. 

You can also use the INETD server of TCP/IP V2.0 for OS/2 to start the Telnet 
server, but when doing so you cannot define start parameters for the Telnet 
server. 

The following screen shows the OS/2 Telnet server: 



® Copyright IBM Corp. 1990 1992 1993 
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— 



Telnet Server (Telnetd) 

(C) Copyright IBM Corp. 1991 



Version: 1.2.1 
Created: Feb 25 1993 
Time: 17:16:28 



Note: Don't be confused by the version number; it still says 1.2.1. 

For a more detailed discussion of Telnet server parameters see the TCP/IP V2.0 
for OS/2 User's Guide. 

Another way to handle remote logins to your OS/2 workstation is to use the 
LOGINUNX.EXE command. Normally, the Telnet server calls LOGIN.EXE to 
prompt remote users for the password specified in the TELNET. PASSWORD.ID 
variable. You need to rename LOGINUNX.EXE to LOGIN.EXE in order to use it 
(don't forget to save the original LOGIN.EXE first). That will handle remote login 
requests similar to a UNIX system by prompting a user for user ID and password 
before granting access to your OS/2 system. 

Using LOGINUNX.EXE does not require the TELNET.PASSWORD.ID environment 
variable at all. but it does require a PASSWD file in the \TCPIP\ETC directory. 
This file will hold the user IDs and encrypted passwords, so that no user can see 
somebody else's password. 

Note: Since TCP/IP V2.0 for OS/2 does not provide a tool to create or maintain a 
PASSWD file, you need to copy an existing one from a UNIX system 
(where it is located in the /etc directory). 

From an IBM AIX system, you need both, the /etc/passwd and the 
/etc/security/passwd (holds the encrypted passwords) files. 

A PASSWD hie on an AIX system may look like this: 

root: !:0:0::/:/bin/ksh 
daemon: ! : 1: 1: : /etc: 
bin:!:2:2::/bin: 
sys: !:3:3::/usr/sys: 
adm: !:4:4::/usr/adm: 
uucp: !:5:5::/usr/lib/uucp: 
guest: ! : 100: 100: :/usr/guest: 
nobody: 1:4294967294:4294967294::/: 
lpd: ! : 104:9: :/; 

martin:!: 202 : 1 : Mart i n Mur hammer : /u /marti n : /bi n /ksh 
miers: !:203:l:Scott Miers:/u/miers:/bin/ksh 

For LOGINUNX.EXE to handle logons, the following PASSWD file will do: 

marti n:Zw28Dfu8PrUu6: 
miers: jwWLz ImmJ n vmc : 

It will allow users martin and miers to log on to the OS/2 Telnet server, each with 
his unique password. All other parameters of the UNIX style PASSWD file will be 
ignored by LOGINUNX.EXE. 
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To log out from the Telnet server you must type exit at an OS/2 command 
prompt. The logout command found in previous versions of TCP/IP for OS/2 no 
longer exists. 

Note: TELNETD uses functions of OS/2 that support full-screen sessions only. 

As a result, the remote logon client must only run full-screen applications. 
Presentation Manager applications are not visible when executed 
remotely, nor are DOS or Win/OS2 applications. The rule of thumb is that 
any application other than OS/2 full-screen is likely to hang the Telnet 
session, or worse, it may hang your system as well as the Telnet server. 
And even OS/2 full-screen applications may cause problems on some 
Telnet clients if they use colors, so be careful when accessing an OS/2 
Telnet server. 



3.1.1 Logon from UNIX Workstations 

From AIX you will normally log on in line mode with the command: 
tn hostjiame 



or 



tn IP address 

At the following AIX command prompt a command similar to above - tn 
9.67.38.81 - has already been entered. You will get the following screen where 
the Telnet password must be entered. 

Note: This example shows a login to the OS/2 Telnet server using the 
LOGINUNX.EXE program. 



— 

OS/2 Version 2.1 (martin) 
login smart in 
password: 



If the hostname environment variable in OS/2 is set, for example, to martin, you 
will get a command prompt in the format shown on the following screen. 



’'i 

OS/2 Version 2.1 (martin) 

loginsmartin 

password: 

6 

[<martin>-C:\] 



You can change this prompt, or even create your personal greeting banner 
within the TELNETD.CMD file in the \TCPIP\BIN directory. However, you then 
have to start the Telnet server using that command file. 

To log out and close the session with the OS/2 Telnet server you should enter 
the command exit. 
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3.1.2 Logon from 3270 Workstations 

If the Telnet server is started on an OS/2 workstation, a user at an MVS or VM 
connected 3270 terminal can log on to OS/2 in line mode. 

To do so, enter: 
tel net 

on a CMS or TSO command line and specify the IP address of the OS/2 host that 
you want to be connected to. 

The following shows an example of running the OS/2 DIR 0* command from a VM 
Telnet client: 



— 

OS/2 Version 2.1 (martin) 

login:martin 

Password : 



[<martin>-C:\]dir o* 

The volume label in drive C is 0S2. 

The volume Serial Number is A5EE:E414 
Directory of C:\ 

7-13-93 l:39p <DIR> 0 0S2 

0 bytes used 
9981953 bytes free 

[<martin>-C:\] 



Telnet J 



Figure 48. Telnet to OS/2 from VM 



3.1.3 Logon from 5250 Workstations 

If the Telnet server is started on an OS/2 workstation, a user at an AS/400 
connected 5250 terminal can log on to OS/2 in line mode. 

To do so, enter: 
telnet 

on an OS/400 command line and specify the IP address of the OS/2 host that you 
want to be connected to. You can likewise start a Telnet Session from the 
Access a Remote System, or the TCP/IP Administration menus of OS/400. 

The following shows an example of running the OS/2 DIR T* command from an 
OS/400 Telnet client: 
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OS/2 Version 2.1 (nartin) 

login: mart in 

password: 

0 

[<nartin>-C:\]dir t* 

The volume label in drive C is 0S2. 
The Volume Serial Number is R5EE:E414 



Directory 


of C:\ 








7-16-93 


3:49p 


<DIR> 


0 


TCPIP 


7-22-93 


5:27p 


2001 


0 


telnet.log 


7-26-93 


3: 18p 


164 


Q 


telnetd. log 


8-02-93 


9:46a 


<DIR> 


0 


TEMP 


7-13-93 


3:31p 


<DIR> 


0 


tools 


5 


file(s) 


2165 bytes used 



9981952 bytes free 



[<martin>-C:\ 




Figure 49. Telnet to OS/2 from OS/ 400 



3.1.4 Logon from DOS Workstations 

You can log on to OS/2 in line mode from your DOS workstation using a Telnet 
client program, for example from the IBM TCP/IP V2.1 for DOS product. To do 
this enter the TELNET command on a DOS command prompt, or use the Windows 
3.1 user interface for Telnet named WTelnet. WTelnet can be found in the TCP/IP 
for DOS group on the Windows 3.1 Desktop. The DOS Telnet client supports the 
following terminal emulations: 

• VT220 

• VT100 

• ANSI 

• IBM 3278-2 

The Windows WTelnet client supports the following terminal emulations in 
addition to the above: 

• TTY 

Telnet prompts you with the Telnet menu interface, a menu-driven interface that 
makes it easy to supply the information needed to begin a Telnet session. After 
you enter the hostname or the IP address of the Telnet server, the hosts 
negotiate which terminal emulation to use. If this negotiation succeeds, and if 
the hostname environment variable in OS/2 is set, for example to martin, you will 
get an OS/2 prompt like the following: 

[martin:C:\] 

showing the TCP/IP hostname and the current directory. 

To close the Telnet session with the OS/2 Telnet server enter exit at the 
command prompt. You should be careful not to execute a command file that 
contains an exit statement, because that will end the Telnet session. 
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For more details on the DOS Telnet clients and server, please see the IBM 
TCP/IP 2.1 for DOS product documentation. 

3.1.5 Logon from OS/2 Workstations 

There are several possibilities to remotely log on to another OS/2 system 
running TCP/IP V2.0 for OS/2. See 3.2.2, "ASCII-Based Telnet Clients” on 
page 63 for a more detailed description of OS/2 Telnet clients. 

The preferred terminal type between OS/2 systems is ANSI, which gives 
full-screen support including colors. The remote Telnet session works exactly 
like a local full-screen OS/2 session (including retrieve command support) with 
the following exceptions: 

• The cursor shape is not handled, because it is not supported by ANSI. A 
full-screen editor that, for example, changes the cursor shape to a block to 
indicate insert mode will still show an underline cursor, although insert mode 
will work. 

• To quit a terminal session with an OS/2 Telnet server, type exit at the 
command prompt. This will return you to the Presentation Manager window 
where you started the ANSITERM session from. 

• The mouse is not supported in a remote session (for example, in the IBM 
Extended Services/2 V1.0 Communications Manager or IBM OS/2 LAN Server 
V3.0 full-screen interface programs). 

• It is not possible to interrupt a program by entering Ctrl-Break. The 
command Ctrl-] will put you at a Telnet command prompt. If you then enter 
send ip, you are put back in connected mode. 

To log on to the remote OS/2 system enter: 
ansi term hostname 

from an OS/2 command prompt, or start a TelnetPM object and select the 
emulator type to be ANSI. 

If the OS/2 environment variable hostname is set on the remote OS/2 system, 
the host name of the remote system appears in the command prompt of your 
remote session to distinguish it from a local OS/2 session. 

On the OS/2 Telnet server you can see logged-on clients on the OS/2 window list 
as Telnet Session: 



telnetd.exe 
telnet.exe 
Telnet Session 
Telnet Session 














Figure SO. Window List on an OS/2 Telnet Server 



To find out who is actually connected into your system, the following command is 
helpful: 
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\ 

[C:\tcpip\bin]netstat -s 



SOCK 


TYPE 


FOREIGN 

PORT 


LOCAL 

PORT 


FOREIGN 

HOST 


STATE 


8388 


3888888888 


SSSSSS8888 


s=s=c:=s=£;= 


&SSSS8SSSS 


SS8SSS8SSS 


15 


STREAM 


1024 


telnet. .23 


9.67.38.81 


ESTABLISHED 


14 


STREAM 


telnet. *23 


1024 


9.67.38.81 


ESTABLISHED 


12 


STREAM 


1024 


telnet.. 23 


9.67.38.106 


ESTABLISHED 


11 


STREAM 


0 


shell.. 514 


0.0. 0.0 


LISTEN 


ie 


STREAM 


0 


exec.. 512 


0.0. 0.0 


LISTEN 


9 


STREAM 


0 


ftp.. 21 


0.0. 0.0 


LISTEN 


8 


STREAM 


6 


telnet.. 23 


0.0. 0.0 


LISTEN 


[C:\tcpip\bin] 











This command lists the sockets that are in use in your TCP/IP host, and what 
applications are using it. A name with a number in the local port column means 
a server on your workstation. A number only in the local port column means a 
client on your workstation. In this example, host 9.67.38.81 made a telnet to his 
own IP address, so it shows a client and server task for Telnet in addition to the 
listening Telnet server that is waiting for more connections. 



3.1.6 Logon from DEC/VMS 

The following example shows a Telnet session from a DEC MicroVAX system to 
the OS/2 TCP/IP host cidserver. The DEC system runs the VMS operating 
system which has no TCP/IP capability by itself, so the MultiNet application was 
installed on top of VMS. 

Therefore, TCP/IP related commands must be prefixed by the multi net 
statement: 
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$ multinet telnet 9*67.38.115 
Trying... Connected. 



OS/2 Version 2.1 (cidserver) 

login:martin 

password: 

0 

[<cidserver>-C:\]dir *. 

The volume label in drive C is CJDRIVE. 
The Volume Serial Number is E641:C414 
Directory of C:\ 



7-14-93 


l:53p 


<DIR> 


0 


# 


7-14-93 


l:53p 


<DIR> 


0 


# , 


8-23-93 


4:22p 


<DIR> 


0 


$cidtmp$ 


7-20-93 


5:45p 


<DIR> 


0 


CID 


7-14-93 


2:37p 


<DIR> 


1317 


Desktop 


7-14-93 


2:33p 


<DIR> 


0 


IBMCOM 


7-19-93 


10:15a 


<DIR> 


0 


LANLK 


7-14-93 


2:52p 


<DIR> 


0 


MUGLIB 


8-05-93 


3:25p 


<DIR> 


0 


nbtcp 


7-14-93 


2:37p 


<DIR> 


252 


Nowhere 


7-14-93 


2:03p 


<DIR> 


0 


0S2 


7-14-93 


2:03p 


<DIR> 


0 


PSFONTS 


5-11-93 


8:10p 


40415 


0 


README 


7-20-93 


5:48p 


<DIR> 


0 


SERVER 


7-14-93 


2:37p 


<DIR> 


0 


SPOOL 


7-14-93 


2:34p 


<DIR> 


0 


srvifsrq 


16 file(s) 


40425 bytes used 



8994816 bytes free 



^ [<cidserver>-C:\] 



3.2 TCP/IP V2.0 for OS/2 Telnet Clients 

Telnet clients give you the option to log on to and emulate terminals on remote 
systems. TCP/IP V2.0 for OS/2 includes the following Telnet clients: 



TelnetPM 


ASCII-based Telnet client running either as a Presentation 
Manager, as an OS/2 window, or as an OS/2 full-screen 
application. 


Telnet 


ASCII-based Telnet client running as an OS/2 window or OS/2 
full-screen application. 


Ansiterm 


ASCII-based Telnet client running as an OS/2 window or OS/2 
full-screen application providing color support. 


Telneto 


ASCII-based Telnet client running in true line mode as an OS/2 
window or OS/2 full-screen application. 


3270 Telnet 


3270-based Telnet client running as a Presentation Manager 
application. 


TN3270 


3270-based Telnet client running as an OS/2 window or OS/2 
full-screen application. 
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Telnet 5250 5250-based Telnet client running as a Presentation Manager 
application. 

The ASCII-based clients can emulate one of the following types of terminals: 

• VT220 

• VT100 

• ANSI 

• HFT 

• NVT 

3.2.1 Workplace Shell Integration of Telnet Clients 

Two of the Telnet clients that come with TCP/IP V2.0 for OS/2, TelnetPM and 3270 
Telnet, are implemented as objects of the OS/2 Workplace Shell. They can be 
found in the Templates folder on the OS/2 Desktop after TCP/IP V2.0 for OS/2 
has been installed. 

The following shows part of a Templates folder containing the Workplace Shell 
objects created by TCP/IP V2.0 for OS/2: 



Pf Templates - Icon View 






Mil 




lii 


^1 


li/e 



Network Printer Program FontPaJette Color Palette Scheme 



a 

FTPPM Telnet 3270 Telnet ||j 

MEmMZZ 1 liSE ," 1 

Figure 51. Templates Folder with TCP/IP Objects 

You can create multiple instances of these templates by dragging a template 
object onto the OS/2 Desktop using the right mouse button. 

To configure an instance of TelnetPM, see 3.2.3, "Configure TelnetPM" on 
page 64. 

To configure an instance 3270 Telnet, see 3.2.7, “Configure 3270 Telnet” on 
page 70. 

3.2.2 ASCII-Based Telnet Clients 

The TCP/IP V2.0 for OS/2 ASCII-based Telnet clients are tailored to support 
specific terminal types. You have the option of selecting a client that best suits 
your communication needs. 

All of the ASCII-based clients will negotiate which emulation to use in the 
following order: 

• VT220 

• VT100 

• ANSI 

• HFT 

• NVT 

If the server you want to communicate with expects another terminal type, you 
must set the TERM variable to the string the server is expecting. For example, 
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you can use the following command to communicate with a SUN host that 
expects the terminal type name VTIOO-sun: 

set TERM=vtl00-sun 

You can have several Telnet connections running concurrently to different Telnet 
servers. To do this, start each Telnet client at an OS/2 command prompt, or 
start multiple instances of TelnetPM. 

The following screen shows an OS/2 Telnet client logging on to a DEC/VMS 
system running MultiNet: 



— 
******** ITSC Open Network Management Lab ******** 

Username: SYSTEM 
Password: 

Last interactive login on Wednesday, 25-AUG-1993 10:17 
Last non-interactive login on Tuesday, 24-AUG-1993 16:55 
International Technical Support Laboratory 
Raleigh 
ITCSV1 

%DCL-E-OPENIN, error opening PNTDIR:[EXE]SIX2SYM.C0M; as input 
-RMS-F-DEV, error in device name or inappropriate device type for operation 
$ * 

$ dir m* 

Di rectory SYSJSYSROOT : [SYSMGR] 

MAIL.DIR;1 MAIL.MAIjl MARTIN. 0IR}2 MARTIN. DIR;1 

MCC_DNA4 EVL.L0G;14 MCC_N0DE4_L0AD . TMP ; 1 
HCC_ST ARTUP_BMS . LOG ; 16 ~ 

Total of 7 files. 

Directory SYS$C0MM0N: [SYSMGR] 

MAKEROOT .COM; 1 MCC_EXPORTER BACKGROUND. C0M;1 

MCC_HI STORI AN_BACKGROUND . COM ; 1 

Total of 3 files. 

Grand total of 2 directories, 10 files. 

$ 

— 



3.2.3 Configure TelnetPM 

To configure an instance of the TelnetPM object, double-click on the object for 
the first time, or select Open Settings. Select the appropriate tag in the 
notebook-style configuration window and fill in the necessary values for your 
Telnet session. 

If you just want to create a generic TelnetPM instance in order not to 
overpopulate your desktop with objects, leave all fields blank. Only click on the 
Create New Window radio button on the Window menu. You can then enter all 
communication parameters after starting TelnetPM. 

The following figures show the first two pages of the TelnetPM configuration 
notebook: 
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Figure 52. Telnet Page of the TelnetPM Configuration Notebook 



On the Telnet page you specify necessary communications parameters. 

Setting Meaning 

Host Hostname or IP address of the Telnet server you wish to 

communicate with. 

Port Port number or port name to use for this session. If you 

leave this field blank (recommended), the Telnet port as 
specified in the SERVICE file in the \TCPIP\ETC directory 
will be used. 

Terminal Type Can be one of the following: 

• VT100 

• VT220 

• ANSI 

• HFT 

• NVT 

• default 

Code page Used, if necessary, to translate international characters. 

Country keyboard Used to emulate national keyboards. 

Configuration file Used to specify a keyboard remap file. See 3.2.10, 

“Keyboard Remap for Telnet Clients” on page 74 about 
remapping a keyboard for TelnetPM. 

Log file Specify where you want to log a TelnetPM session. 

Trace file Specify where you want to trace a TelnetPM session. 
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Figure S3. Session Page of the TelnetPM Configuration Notebook 

On the Session page you specify how a TelnetPM session is to be represented 
by OS/2. 

Setting Meaning 

Session type Select the way you want that instance of TelnetPM to appear on 
your desktop. 

Screen Size Select the size of the screen for that instance of TelnetPM in 
number of rows by number of columns. 

On the third page of the TelnetPM configuration notebook, the Environment page 
which is not shown here, you specify environment variables that you want to be 
set for this session on the remote system. If a remote system does not support 
exchanging of environment variables, TelnetPM will prompt you whether you 
would like to continue without exporting any variables. 

Some of the settings discussed above can be changed once a TelnetPM instance 
is started. At this time you can also change settings that only control an active 
session and can therefore not be pre-set. 

The following shows an active TelnetPM session with opened Options pull down 
menu and the Line Mode Simulation option activated: 
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IBM MX Uersion 3 for RISC Systen/6000 

(C) Copyrights by IBM and by others 1982, 1991. 

login: 



: :rir- ••••=•, «r! «• :r; ■: :y.:- . • .= ' fej Seh(l 



Figure 54. Configuring an Active TelnetPM Session 



Menu 

Session 

Edit 

Commands 

Options 



Control or Configuration 

Used to start and stop a Telnet session. 

Used to cut and paste data from or to this session. 

Used to send Telnet session commands to the remote host. 
Used to control configuration values for this session, and to 
change values that have been specified in the TelnetPM object 
settings. 



For a more detailed discussion of these settings see the TCP/IP V2.0 for OS/2 
User's Guide. 



The line mode option gives you the possibility to edit a command before entering 
it, and to retrieve previously entered commands from a list. 



3.2.4 Using New TelnetPM Features 

With the previous version of TCP/IP for OS/2, it required some work-around to 
get a 3270 Emulation through HCON since the HFT terminal type and a 25 line 
display were not directly supported. 

The following screen shows a TelnetPM session to an AIX system, using HFT 
terminal type, a screen size of 25x80 characters, and emulating a 3270 display 
using HCON: 
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Figure 55. HCON Session with TeinetPM 



3.2.5 Telneto - True Line Mode Telnet Client 

You can use the Telneto program if you require true line mode for a Telnet 
session rather than the line mode simulation of TeinetPM. You can start a 
session directly by entering: 

Telneto hostname 



or 



Telneto IP_addres$ 

When you start Telneto without the above parameters, you are taken to the 
Telneto command prompt. From there, you can issue Telneto subcommands 
such as the open command that starts a Telnet session, or the quit command 
that exits from Telneto. 

Note: There is no keyboard remap facility for Telneto. 

The following screen shows a Telneto session with a SUN SPARCStation: 



r >v 

Connected to sun. 

Escape character is 
SunOS UNIX (SPSUN099) 

login: root 

Last login: Thu Aug 19 11:57:02 on console 

SunOS Release 4.1.3 (GENERIC) #3: Mon Jul 27 16:43:54 PDT 1992 



SPSUN9G9# 

J 
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For a more detailed discussion of the Telneto subcommands see the TCP/IP V2.0 
for OS/2 User's Guide. 



3.2.6 3270-Based Telnet Clients 

3270 Telnet is an OS/2 Presentation Manager application and supports the 
mouse pointing device, whereas TN3270 is an OS/2 character-based application. 
We suggest that you use the TN3270 client when utilizing a serial line (SLIP) 
because it is somewhat faster than the 3270 Telnet client, even though 3270 
Telnet offers you more functionality. 



To use TN3270 or 3270 Telnet, a Telnet server must be running on a foreign host 
that supports a 3270 terminal emulator such as provided by the IBM TCP/IP for 
VM and TCP/IP for MVS programs. 

Notes: 

1. TN3270 and 3270 Telnet do not support HLLAPI and host graphics using 
GDDM. 

2. There is no INDSFILE file transfer capability for TN3270 and 3270 Telnet. 

3. There is no PASTE feature in 3270 Telnet. 

You will find a brief description of the TN3270 command and the default keyboard 
mapping in the TCP/IP V2.0 for OS/2 User's Guide. 

The following shows the differences between 3270 Telnet and TN3270. 3270 
Telnet has a menu bar to allow configuration and control over an active 3270 
Telnet session. To get to the TN3270 Main Menu press the Ctrl ] keys. This will 
prompt you with a screen similar to the following: 



MHd : 



UM/ESA ONLINE 



TN3270 Ha In Menu 



Change colors 



Save co 



- Raleigh Systems Services and Support 



UU TTTTTT CCCCCC EEEEEE SSSSSS AAAAAA 



TT CC 



EE 



Refresh 
Exit TN 



Uisitor 

(lls: 

Fill in y 
(Your pas 
USERID 
PASSU0RD 

COMMAND 



Field Name 


Color 








DEFAULT INTENSE 


Light magenta 


PROTECTED NUMERIC 


Cyan 


PROTECTED INTENSE 


Yellow 


UNPROTECTED NUMERIC 


White 


UNPROTECTED INTENSE 


Intense white 


DEFAULT 


White 


BLUE 


Light blue 


RED 


Light red 


PINK 


Light magenta 


GREEN 


Light green 


TURQUOISE 


Light cyan 


YELLQU 


Yellow 


UNITE 


Intense white 



SS AA AA 

SS AA AA 

SSSSS AAAAAA 
SS AA AA 
SS AAKAA 
SSSSS AA^AA 

: 00-9: 08 
e 8-352-2007 
UMEXIT 

n Access Your Office System 
1: Approved Purposes Only) 

ER 

t) 



RUNNING UTCESft 



Figure 56. TN3270 Main Menu 
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3.2.7 Configure 3270 Telnet 

To configure an instance of the 3270 Telnet object, double-click on the object for 
the first time, or select Open Settings. Select the appropriate tag in the 
notebook-style configuration window and fill in the necessary values for your 
3270 Telnet session. 

If you just want to create a generic 3270 Telnet instance in order not to 
overpopulate your desktop with objects, leave all fields blank. Only click on the 
Create New Window radio button on the session menu. You can then enter 
communication parameters after starting 3270 Telnet. 

The following figures show the first two pages of the 3270 Telnet configuration 
notebook: 




Figure 57. 3270 Telnet Page of the 3270 Telnet Configuration Notebook 



On the 3270 Telnet page you specify necessary communications parameters: 



Setting 

Host 

Port 



Translation 



Enable Extended Datastream 



Meaning 

Hostname or IP address of the 3270 Telnet server 
you wish to communicate with. 

Port number or port name to use for this session. 

If you leave this field blank (recommended), the 
Telnet port as specified in the SERVICE file in the 
\TCPIP\ETC directory will be used. 

Specify the file name of the translation table for 
translating between ASCII and EBCDIC. By default, 
3270 Telnet uses the file 3278XLT.TBL, located in 
the ETC directory, or the default US translation 
table. 

Supports extended colors, highlighting, and 
nonstandard displays. 
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Disable the Bell 
Enable Square Brackets 
Maintain Screen Size 



Used to suppress beep signals for host screen 
refreshes. 

Used to show square brackets and backslashes as 
they appear on the keyboard. 

Used to prevent the emulator to change the screen 
size according to the host program. 




Figure 58. Session Page of the 3270 Teinet Configuration Notebook 

On the session page you specify how a 3270 Telnet session is to be represented 
by OS/2. 

Setting Meaning 

Session type Select the way you want that instance of TelnetPM to appear on 
your desktop. 

Screen Size Select the size of the screen for that instance of TelnetPM in 
number of rows by number of columns. 

Some of the settings discussed above can be changed once a TelnetPM instance 
is started. At this time you can also change settings that only control an active 
session and can therefore not be pre-set. 

The following shows an active 3270 Telnet session with the opened Configuration 
pull-down menu: 
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Password *•«*> Now Pi issword ™> 



Procedure *“*> SRI SC Group f dent "-■*■> 

ftcct Mir ™> 222222 
Sizr? 4096 

Per fori? 

Crmroand -*-> 

Enter an ‘S' before each option desired below: 

-Ko&ail -Honoticc -‘Reconnect -Of Dear ri 



PF1/PF13 ==> Help PF3/PF15 ==> Logoff . PHI ==> Attention PA2 ==> ReshoJ 
Vou nay request specific help information by entering a ? m any entry field I 




Figure 59. Configuring an Active 3270 Telnet Session 



Menu 

Mark 

Configuration 



Fonts 



Control or Configuration 

Used to copy screen data to the OS/2 clipboard. 
Used to configure the following emulator settings: 

• Color settings 

• Mouse action 

• Keyboard remap 

Used to change the font for an emulator session. 



The following shows the color mapping menu of a 3270 Telnet session: 



Color Selection ■ • 



3278 Terminal Fields 



Unformatted Field 



Default Intensified 
Field 62 
Field 83 

Protected Numeric 
Protected Intensified 





Apply j j Cancel 



i;l ISliiffli 






Figure 60. Color Mapping of an Active 3270 Telnet Session 



For a more detailed discussion of these settings see the TCP/IP V2.0 for OS/2 
User's Guide. 
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3.2.8 5250-based Telnet Clients 

This feature is new in TCP/IP V2.0 for OS/2 and allows you to log on to an 
AS/400 system that is running a Telnet server. You can start TN5250 either from 
an OS/2 command prompt or from the TCP/IP folder. 

Since establishing a Telnet session to an AS/400 may take several seconds, you 
might get a message that tells you that session establishing is still going on. 
Answer Continue in this message box to allow TN5250 to finish to connect to the 
remote system. 

You can change settings that control an active session once it has been 
established. The following shows an active TN5250 session with the opened 
Fonts pull-down menu: 




Mark ^Configuration §|gorits^|Exit 



tlttlM 



'4G0 Main Menu 



K 

2 . 

3 . 

4. 

5. 

6. 
7. 
0. 
9. 

10 . 

11 . 



User tasks 
Office tasks 
General system 
Files, librarii 
Programing 
Comunications 
Define or chans: 
Problem hancflii 
Display a Menu 
Information ftj 
PC Support ta; 



90. Sign off 
Selection or command 




System: R0LV0S4B 



(C) COPYRIGHT IBM CORP. 1980, 1992. 

■ mrert-off 



Figure 61. Configuring an Active TN5250 Session 

Menu Control or Configuration 

Mark Used to copy screen data to or from the OS/2 clipboard. 

Configuration Used to configure the following emulator settings: 

• Mouse action 

• Keyboard remap 

Fonts Used to change the font for an emulator session. 

For a more detailed discussion of these settings see the TCP/IP V2.0 for OS/2 
User's Guide. 
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3.2.9 Mouse Support for 3270 Telnet and TN5250 

3270 Telnet and TN5250 both support the use of a mouse to perform pre-defined 
actions in an active emulator session. You can map the right and left mouse 
buttons to one of the 12 PF keys or the Enter key. Mapping can be configured for 
both single and double-click action. 

The following shows the Mouse Configuration window as it shows up from the 
Configuration pull-down menu of 3270 Telnet and TN5250: 




Figure 62. Mouse Configuration for 3270 Telnet and TN5250 Sessions 



3.2.10 Keyboard Remap for Telnet Clients 

TCP/IP V2.0 for OS/2 allows you to remap the terminal keyboard for all types of 
emulated terminals. 

3.2.10.1 The SETTERM Program 

The SETTERM program is used to remap the keyboard for the ASCII-based 
Telnet clients TelnetPM and Telnet, including National Language keyboard 
layouts. It is a DOS application that can be run in either DOS windowed or DOS 
full-screen mode. DOS full-screen mode is faster and therefore preferred. 

SETTERM guides you through the remap process of your terminal session 
keyboard by displaying an emulator keyboard layout. You can view and change 
keys interactivley for the following types of terminal emulators: 

• VT220 

• VT100 

• ANSI 

The following shows SETTERM remap for a German keyboard for a VT220 
terminal: 
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Figure 63. Telnet ASCII Emulator Keyboard Remap using SETTERM 



The file created or modified by SETTERM usually has the extension .CFG. 



3.2.10.2 3270 Telnet, TN3270, and TN5250 Keyboard Remap 

To control the ASCII-to-EBCDIC translation for 3270 Telnet, the file 3278XLT.XLT 
is used. It is provided as a sample for the US translation table as 3278XLT.SAM, 
which is shown in the following example: 



» 



; ASCII-to-EBCDIC ti 
; 00 01 02 03 04 05 

40 40 40 40 40 40 

40 40 40 40 40 4© 

40 5A 7F 7B 5B 6C 
F0 FI F2 F3 F4 F5 
7C Cl C2 C3 C4 C5 
D7 D8 D9 E2 E3 E4 
79 81 82 83 84 85 
97 98 99 A2 A3 A4 
68 DC 51 42 43 44 
71 9C 9E CB CC CD 
45 55 CE DE 49 69 
40 40 40 40 40 65 
40 40 40 40 40 40 
8C AC 72 73 74 40 
EE 59 EB ED CF EF 
CA 8F 40 B9 B6 B5 



ible for English (US) 
06 07 08 09 0A 0B 0C 

40 40 40 40 40 40 40 
40 40 40 40 40 40 40 
50 7D 4D 5D 5C 4E 6B 
F6 F7 F8 F9 7A 5E 4C 
C6 C7 C8 C9 D1 D2 D3 
E5 E6 E7 E8 E9 BA E0 
86 87 88 89 91 92 93 
A5 A6 A7 A8 A9 C0 4F 
47 48 52 53 54 57 56 
DB DD DF EC FC 70 B1 
9A 9B AB AF 5F B8 B7 
62 64 B4 40 40 40 40 
46 66 40 40 40 40 40 
75 76 77 40 40 40 40 
A0 8E AE FE FB FD 8D 
El 9D 90 BD B3 DA FA 



CECP Code Page 037 
00 0E 0F 


40 40 40 


00 


40 40 40 


10 


60 4B 61 


20 


7E 6E 6F 


30 


04 D5 D6 


40 


BB B0 6D 


50 


94 95 96 


60 


D0 A1 40 


70 


58 63 67 


80 


86 BF 40 


90 


AA 8A 8B 


A0 


4A B2 40 


B0 


46 40 9F 


CO 


6A 78 40 


00 


AD BC BE 


E6 


EA 40 41 


F0 



; EBCDIC-to-ASCII table for English (US) CECP Code Page 037 
; 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 



00 01 02 03 1A 09 1A 1A 1A 1A 1A 0B 0C 0D 0E 0F 
10 11 12 13 1A 1A 08 1A 18 19 1A 1A 1C ID IE IF 
1A 1A 1A 1A 1A 0A 17 IB 1A 1A 1A 1A 1A 05 06 07 



60 

10 

20 
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1A 


1A 


16 


1A 


1A 


1A 


c 
«— 1 


04 


1A 


1A 


1A 


1A 


14 


15 


1A 


1A 


; 30 




20 


FF 


83 


84 


85 


A0 


C6 


86 


87 


A4 


BD 


2E 


3C 


2B 


2B 


7C 


; 40 




26 


82 


88 


89 


8A 


A1 


8C 


8B 


8D 


El 


21 


24 


2A 


29 


3B 


AA 


; 50 




2D 


2F 


B6 


8E 


B7 


B5 


C7 


8F 


80 


A5 


DD 


2C 


25 


5F 


3E 


3F 


; 60 




9B 


90 


D2 


D3 


D4 


D6 


D7 


D8 


DE 


60 


3A 


23 


40 


27 


3D 


22 


; 70 




9D 


61 


62 


63 


64 


65 


66 


67 


68 


69 


AE 


AF 


D0 


EC 


E7 


FI 


; 80 




F8 


6A 


6B 


6C 


6D 


6E 


6F 


70 


71 


72 


A6 


A7 


91 


F7 


92 


CF 


; 90 




E6 


7E 


73 


74 


75 


76 


77 


78 


79 


7A 


AD 


A8 


D1 


ED 


E8 


A9 


; A0 




5E 


9C 


BE 


FA 


B8 


F5 


F4 


AC 


AB 


F3 


5B 


5D 


EE 


F9 


EF 


9E 


; B0 




7B 


41 


42 


43 


44 


45 


46 


47 


48 


49 


F0 


93 


94 


95 


A2 


E4 


5 C0 




7D 


4A 


4B 


4C 


4D 


4E 


4F 


50 


51 


52 


FB 


96 


81 


97 


A3 


98 


; D0 




5C 


F6 


53 


54 


55 


56 


57 


58 


59 


5A 


FD 


E2 


99 


E3 


E0 


E5 


; E0 




30 


31 


32 


33 


34 


35 


36 


37 


38 


39 


FC 


EA 


9A 


EB 


E9 


1A 


; F0 





You might need to edit this table in order to display NLS characters properly 
according to the code page that you are using. You need a reference of the host 
code page and the OS/2 codepage to do so. 

To control the ASCII-to-EBCDIC translation for TN5250, the file 5250XLT.XLT is 
used. It is provided as a sample for the US translation table as 5250XLT.SAM. 

To refresh the keyboard remap from within a PMANT session through the 
Configuration Menu, a file named PMANT.KEY must exist in the \TCPIP\ETC 
directory. This will be taken as the input file and can be revised using any ASCII 
editor. 

To refresh the keyboard remap from within a TN3270 session through the Main 
Menu, a file named TN3270.KEY must exist in the \TCPIP\ETC directory. This 
will be taken as the input file and can be revised using any ASCII editor. 

To refresh the keyboard remap from within a TN5250 session through the 
Configuration Menu, a file named TN5250.KEY must exist in the \TCPIP\ETC 
directory. This will be taken as the input file and can be revised using any ASCII 
editor. 

Samples of the PMANT.KEY and TN5250.KEY files are included in the TCP/IP V2.0 
for OS/2 User's Guide. 

Notes: 

1. PMANT.KEY can also be used as TN3270.KEY 

2. You can only remap 3270 or 5250 functions to OS/2 keys, not NLS characters. 

3. Use the .XLT files to remap NLS characters according to your 3270 or 5250 
host code page and your OS/2 code page. 

3.2.10.3 The TELNET.RC File 

The Telnet.RC file in the ETC directory is a text file used to specify commands to 
a Telneto client that the user would normally have to type in by hand. The 
Telnet.RC file is made up of sections that define commands to be entered when 
using the line mode Telnet client to a particular host. These commands are 
entered on behalf of the user as if they were typed in at a particular Telneto 
command prompt. 

Each section is identified by a line that starts with the name of the host that is 
being connected to. The rest of the line, and successive lines in a particular 
section, begin with white space and are assumed to be Telneto client 
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commands. These commands are processed as if they had been typed in 
manually at the Telneto command prompt. The last line of each section must be 
blank to signify the end of that section. 

The following format rules apply: 

1. Lines beginning with a are comment lines. 

2. Blank lines are ignored. 

3. Lines that begin without white space start a new host entry section. 

4. A blank line signifies the end of a host entry section. 

5. The hostname "DEFAULT" matches for all hosts. 

6. All matching host entry sections will be executed. 

See the following sample of the TelnetRC file: 

# This is a DEFAULT entry that is executed # 

# for all servers that you connect to. # 

DEFAULT send ayt 

toggle local 
set esc A ] 
set interrupt A c 

§ This is a host specific entry that is executed # 

# only when telneting to the host 'paul.itsc.raleigh.ibm.com' # 

paul.itsc.raleigh.ibm.com toggle bs 

set esc A t 
toggle wrap 
toggle crmod 
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Chapter 4. File Transfer 



This chapter describes the ways in which TCP/IP V2.0 for OS/2 may transfer data 
between different hosts in a network. 

In TCP/IP V2.0 for OS/2 the following file transfer protocols are implemented: 

• File Transfer Protocol (FTP) 

• Trivial File Transfer Protocol (TFTP) 

This chapter introduces the integration of FTP clients into the OS/2 Workplace 
Shell, and it also discusses some of the customization requirements for the FTP 
server. 

If you have to make a decision regarding which of the services to use, consider 
that FTP has the following features, which are not available in TFTP: 

• Subcommands to list files or work with directories on the foreign host 

• HPFS file names 

• User authentication 

• An FTP server supports many clients, while a TFTP server supports only one 
client at a time 

• FTP achieves better performance than TFTP 

• FTP uses TCP and TFTP uses UDP. 

The test environments for this chapter are shown in 1.4, “ITSC Raleigh Test 
Environments” on page 11. 



4.1 Workplace Shell Integration of FTP Clients 

One of the FTP clients that come with TCP/IP V2.0 for OS/2, FTPPM, is 
implemented as an object of the OS/2 Workplace Shell. It can be found in the 
Templates folder on the OS/2 Desktop after TCP/IP V2.0 for OS/2 has been 
installed. 

The following shows part of a Templates folder containing the Workplace Shell 
objects created by TCP/IP V2.0 for OS/2: 




Figure 64. Templates Folder with TCP/IP Objects 

You can create multiple instances of these templates by dragging a template 
object onto the OS/2 Desktop using the right mouse button. 



© Copyright IBM Corp. 1990 1992 1993 
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To configure an instance of FTPPM, see 4.2.3, "Configure FTPPM” on page 82. 



4.2 File Transfer Protocol (FTP) 

This section describes the implementation of FTP in the TCP/IP V2.0 for OS/2 
product. 

4.2.1 TCP/IP V2.0 for OS/2 FTP Server 

The OS/2 FTP server uses two files in order to provide user authentication, both 
of which are fiat ASCII files that can be modified by an ASCII editor. 

4.2.1 .1 The TRUSERS File 

The TRUSERS file contains information about the users that are allowed to log 
on to your OS/2 system, their (optional) passwords, and the directories where 
they have read and/or write access to. It is usually stored in the TCPIP\ETC 
subdirectory. 

You may either create this file with an editor, or use the TCP/IP configuration 
notebook to specify the parameters that would then be stored in the TRUSERS 
file. A sample TRUSERS file is shown in the following example: 

user: martin martin 

rcT: 

wr A : 

user anonymous 
rd: c:\tcpip\tmp 
wr: 

This means that the user martin with password martin has read and write access 
to all drives, and that user anonymous (common usage for everyone) has read 
access to the C:\TCPIP\TMP directory and subdirectories but no write access at 
all. 



4.2.1 .2 The NETRC File 

The NETRC file is used for both the FTP and REXEC clients. It contains login IDs 
and passwords and optionally macro definitions or programs to run 
automatically when a user logs on to your OS/2 system. The file does not have 
to be named NETRC or reside in the \TCPIP\ETC-directory. By using the NETRC 
environment variable, the user can choose to place the file under a different 
name and directory for some added security. 

To start the OS/2 FTP server, enter FTPD on an OS/2 command prompt, or start it 
together with the INETD server. 

The following screen shows the OS/2 FTP server: 
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— 



FTP Server (FTPD) 

(C) Copyright IBM Corp. 1991 



Version: 1.2.1 
Created: May 26 1993 
Time: 19:53:18 



FTPDC: spawnned with socket 404 

connection from 9.67.38.81 at Sun Sep 26 17:46:16 1993 
FTP LOGIN FROM 9.67.38.81, martin 



V. J 



4.2.2 TCP/IP V2.0 for OS/2 FTP Clients 

FTP clients give you the option to log on to remote systems in order to trasfer 
files between them and your local OS/2 system. You can use OS/2 FTP clients to 
connect to OS/2, DOS, MVS, VM, OS/400, or UNIX FTP servers. TCP/IP V2.0 for 
OS/2 includes the following FTP clients: 

FTPPM FTP client running as an OS/2 Presentation Manager application. 

FTP FTP client running as an OS/2 windowed or OS/2 full-screen 

application. 

The FTP client is implemented with the standard FTP subcommands such as: 

Subcommand Function 

open Connect to and log on at a remote host 

close End a session with a remote host 

dir List the remote directory 

pwd Display the current remote directory 

led Display or change the current local directory 

get Transfer a file from the remote system 

put Transfer a file to the remote system 

quit End FTP 

Subcommands can be entered from the FTP command shell. You get there by 
entering FTP from an OS/2 command prompt. 

You will find the following hints helpful when using FTP: 

• The exclamation mark ( ! ) invokes the OS/2 CMD processor. Type EXIT to 
get back to the FTP shell. The local current directory can easily be listed by 
typing !dir, while the remote directory is listed by typing dir. 

• A simple way to list a text file on the remote host is to enter get filename 
con. By substituting prn for con the remote file will print on the user's printer. 
The user can actually print the file on a remote OS/2 workstation using put 
filename prn as an alternative to using the LPR command. 

Note that CON and PRN are examples of OS/2 device names and that you 
are not restricted to just those names in a GET or PUT command. Examples 
of other OS/2 device names are COM1 and LPT1. 

• FTP also works with OS/2 drives redirected to an OS/2 LAN Server. That 
means it is possible to use FTP from another environment (for instance 
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S/370) and directly access an OS/2 LAN Server directory. The user must 
have write access to the directory if he wants to copy a file to a foreign host. 

For a more detailed discussion of the FTP subcommands, please refer to the 
TCP/IP V2.0 for OS/2 User's Guide. 

Instead of FTP you can also use the Presentation Manager application FTPPM 
which is part of the TCP/IP V2.0 for OS/2 base product package. The following 
sections describe how to configure and use FTPPM. 

4.2.3 Configure FTPPM 

To configure an instance of the FTPPM object, double-click on the object for the 
first time, or select Open Settings. Select the appropriate tab in the 
notebook-style configuration window and fill in the necessary values for your FTP 
session. 

If you just want to create a generic FTPPM instance in order not to overpopulate 
your desktop with objects, leave all fields blank. Only click on the Create New 
Window radio button on the Window menu. You can then enter all 
communication parameters after starting FTPPM. 

On the first page of the Configuration Notebook (not shown here) you can enter 
the host name or the IP address of the host that you want to connect to. 

The following figures show the second and third pages of the FTPPM 
Configuration Notebook: 




Figure 65. Authentication Page of the FTPPM Configuration Notebook 

On the Authentication page you specify user information. 

Setting Meaning 

User The user ID that you want to log on with at the remote host 
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Passwd The password for the above user ID (if required) 

Account The account information for the above user ID (for VM and MVS, if 
required) 



[^g ?FTRRM ^Settings'll 



Code Pagef if jtcpcodep 

Local: 

Remote: 




{-File Mask 



j Lj Store Unique ; E3GBt Unique 

’ B Use CodePage Prompt 

HI - l£j Two Part File Name 




SlfPftl 



mem 

Ifptil 



Figure 66. Option Page of the FTPPM Configuration Notebook 



On the Options page you specify initial parameters for an FTPPM session. 



Setting 
Code Page 

Directories Local 
Directories Remote 
File Mask Local 
File Mask Remote 
Transfer Type 

Store Unique 



Get Unique 



Use Code page 
Prompt 

Two Part File Names 



Meaning 

Used to convert ASCII characters that are represented 
differently on a remote system than on the local host. 
Name of the local directory for the file transfer 
Name of the remote directory for the file transfer 
Files to be listed from the local directory 
Files to be listed from the remote directory 
Specify whether files to be transferred should be treated 
as text files (ASCII), or as program or image files (binary) 
Store files remotely with unique file names. This will 
assign a new, unique, file name to an eventually existing 
file on the remote host. 

Store files locally with unique file names. This will assign 
a new, unique, file name to an eventually existing file on 
the local host. 

Check here to use the codepage named above. 

Prompt for confirmation before actually transferring files. 
Selected to mark a file for transfer by just marking the 
name. 



For a more detailed discussion of these settings please refer to the TCP/IP V2.0 
for OS/2 User's Guide. 
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4.2.4 FTP to/from UNIX 

File transfer with FTP or TFTP in both directions is supported between OS/2 and 
UNIX. 

The following is an example of opening an FTP session from an AIX session to 
the OS/2 FTP server martin. It also shows the actual settings of the FTP status 
subcommand: 




$ ftp 9.67.38.81 
Connected to 9.67.38.81. 

220 martin FTP server (IBM OS/2 TCP/IP FTP Uersion 1.2) ready. 
Name (9.67.38.81 :martin): murli 
331 Password required for murli. 

Password: 

230 User murli logged in. 
ftp> status 

Connected to 9.67.38.81. 

No proxy connection. 

Mode: stream; Type: ascii; Form: non-print; Structure: file 

Verbose: on; Bell: off; Prompting: on; Globbing: on 

Store unique: off; Receive unique: off 

Case: off; CR stripping: on 

Ntrans: off 

Nmap: off 

Hash mark printing: off; Use of PORT ends: on 
Experimental commands: off 
ftp> _ 



Figure 67. FTP Status on AIX Command Shell 



You can do file transfers in both directions, but remember that you can only 
write on disks to which you have the appropriate rights depending on the user 
rights on AIX/UNIX or the OS/2 TRUSERS file. 

The following screen shows how to use FTP subcommands (they are similarly 
available in AIX as they are in OS/2) to list files in the remote directory, transfer 
the CONFIG.SYS file, and finally list files in the local directory: 
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1 



sn 




Session iiEdit f#Commands €|Optiohs'%|Help 3$ 



331 Password required for murli. 

Password: 

230 User murli logged in. 
ftp> dir c* 

200 PORT command successful. 

150 Opening ASCII mode data connection for c*. 



15259 


07-22-93 


16:10 


CH30LD.SCR 


49714 


07-22-93 


16:11 


CH40LD.SCR 


0 DIR 


07-13-93 


15:17 


CMLIB 


3518 


07-16-93 


17:21 


CONFIG. OKI 


2972 


07-15-93 


17:15 


CONFIG. LAP 


3861 


07-20-93 


12:21 


CONFIG.SYS 


3568 


07-16-93 


16:46 


CONFIG. TCP 


3173 


07-16-93 


15:55 


config.bak 



226 Transfer complete. 
ftp> get CONFIG. SYS 
|200 PORT command successful. 

150 Opening ASCII mode data connection for CONFIG.SYS (3861 bytes). 
226 Transfer complete. 

3861 bytes received in 0.04308 seconds (87.53 Kbytes/s) 
ftp> !ls -l 
total 16 

1 martin staff 3746 Jul 27 13:07 CONFIG.SYS 



j-ru-r — r — 
i-rw-r — i — 



1 martin staff 



lftp> 



3746 Jul 27 12:56 config.sys 



Figure 68. Transfer File from OS/2 to AIX 

You see that the remote (OS/2) directory is C:\ and the local (AIX) directory is 
/home/martin. All you need to do is issue the get command to transfer the file 
from OS/2 to AIX. Transferring a file this way uses the OS/2 FTP server. 
Moreover, FTP provides information about the throughput of each file transfer in 
kilobytes per second. 

Note: You can see that AIX distinguishes between upper and lowercase file 
names, whereas OS/2 actually doesn't. Though HPFS can save file 
names in mixed cases, it wouldn't consider CONFIG.SYS and config.sys to 
be different files, as AIX or UNIX would certainly do. 

To close the FTP session enter the command close and then enter quit to end 
FTP. 

A more comfortable way to do this is to use FTPPM, but remember that FTPPM 
performs the functions of an FTP client. 

The FTPPM client allows file transfer in both directions from a Presentation 
Manager window. To start FTPPM, double-click on an instance of the FTPPM 
object, or enter FTPPM at an OS/2 command prompt. If you didn't already specify 
a host name, user ID, and password in the FTPPM object's settings, you will now 
be prompted to do so. 

After successful logon the contents of the current local and remote directories 
are displayed. You are now able to choose a file for file transfer in either 
direction. 
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/horne/martin 



Remote File Mask: 



* i 




m 











Figure 69. Using FTPPM 



4.2.5 FTP to/from VM 

VM directories contain CMS minidisks. The current directory after the user has 
issued an FTP logon is his A-disk, which is represented as user ID.191. If, for 
example, the user has a 192 disk, the command cd user ID. 192 will make the 192 
disk the current directory. 

Note: An OS/2 FTP user cannot access temporary CMS disks. 

If the user is concurrently logged in to CMS via 3270 emulation, the FTP file 
transfer will only have read access to the A-disk. 

The following figure shows a directory listing of a VM disk using the OS/2 FTP 
client: 
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OS/2 Ctrl* Esc = Uindow List Type HELP = help 

[C:\lftp vm 



Connected to vm. 

220-FTPSERUE at vmesa, 12:47:50 EST TUESDAY 07/27/93 
220 Connection will close if idle for more than 5 minutes. 
Name (vm): tcpipl 
331 Send password please. 

Password: 

230 TCPIP1 logged in; working directory = TCPIP1 191 
ftp> dir 

200 Port request OK. 

125 List started OK 



CGBA 


TEXT 


U 


70 


25 


1 


5/27/93 


13:16:54 


TCPIP1 


HOSTS 


ADDRINF0 F 


158 


30 


5 


5/27/93 


13:20:03 


TCPIP1 


HOSTS 


LOCAL 


U 


46 


17 


1 


5/27/93 


13:19:51 


TCPIP1 


HOSTS 


SITEINF0 F 


56 


30 


2 


5/27/93 


13:20:03 


TCPIP1 


LASTING 


GLOBALU 


U 


20 


1 


1 


7/27/93 


9:53:30 TCPIP1 


PROFILE 


EXEC 


U 


58 


29 


1 


5/24/93 


11:47:52 


TCPIP1 


SCREEN1 


TEST 


U 


79 


25 


1 


5/24/93 


12:31:48 


TCPIP1 


TCPIP1 


NETL0G 


U 


106 


7 


1 


5/28/93 


9:25:15 


TCPIP1 



250 List completed successfully. 

632 bytes received in 0.13 seconds (4 Kbytes/s) 
ftp> _ 



Figure 70 . Listing Fifes in a CMS Minidisk Using FTP 



4.2.6 FTP to/from MVS 

For sequential files a directory is considered one or more data set name 
qualifiers. Use the cd quali fieri, qualified... command to descend the 
directory tree and cd. . command to ascend the tree. If you do a directory listing 
when you have reached the fully qualified name, you will receive the message No 
data sets found. 

To reach a partitioned data set (PDS), enter the fully qualified name of the PDS 
as the directory in the cd command. FTPSERVE will inform you that the working 
directory is now a partitioned data set. A directory listing will show the 
members of the PDS. 

4.2.6.1 Session Example with MVS 

The following example shows an OS/2 FTP session that transfers a text member 
in a PDS data set in MVS to a directory in OS/2. The OS/2 user in the example 
does the following: 

1. Finds the PDS in MVS. Note that FTPSERVE in MVS informs the user that the 
current directory is a PDS. 

2. Checks the contents of the PDS. 

3. Chooses a suitable local directory and goes out to the OS/2 session to check 
the contents of it. 

4. Transfers the PDS member and terminates the FTP session. 
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[C:\]ftp mvsl8sna 
Connected to mvslSsna. 

220-FTPSE18 IBM MVS V2R2 at MVS18.ITSC.RALEIGH.IBM.COM, 15:33:39 on 08/23/93 
220 Connection will close if idle for more than 10 minutes. 

Name (mvsl8sna): murhamm 
331 Send password please. 

Password: 

230 MURHAMM is logged on. 
ftp> pwd 

257 “'MURHAMM.'" is working directory 
ftp> cd .. 

257 is working directory name prefix. 
ftp> cd tcpip.jcl 

257 "TCPIP.JCL" partitioned data set is working directory. 
ftp> dir 

200 Port request OK. 

125 List started OK. 



Name 


VV.MM Created Changed 


Size 


Ini t 


Mod Id 


IEBC0PY 


01.03 89/06/14 89/09/08 13:49 


18 


65 


0 SADTLER 


SRCALLC 


01.00 89/05/11 89/05/11 14:49 


186 


186 


0 SADTLER 


TCALLC1 


01.02 89/06/14 89/06/14 12:42 


189 


272 


0 SADTLER 


TCGETIND 


01.03 89/04/25 89/06/14 09:13 


66 


60 


0 SADTLER 


TCGETINS 


01.00 89/09/08 89/09/08 13:52 


18 


18 


0 SADTLER 


TCPALLC 


01.02 89/04/25 89/05/08 16:28 


96 


96 


0 SADTLER 


TCPAPP 


01.12 89/04/13 89/06/14 12:47 


57 


41 


0 SADTLER 


TCPCLN 


01.05 89/04/19 89/06/14 11:37 


33 


35 


0 SADTLER 


TCPRECV 


01.09 89/04/13 89/06/14 09:17 


41 


40 


0 SADTLER 


TCPREJ 


01.02 89/06/14 89/06/14 09:18 


37 


58 


0 SADTLER 



250 List completed successfully. 

734 bytes received in 0.81 seconds (0 Kbytes/s) 
ftp> led 

Local directory now C:\ 
ftp> led temp 

Local directory now C:\TEMP 
ftp> !dir 



The volume label in drive C is 0S2. 
The Volume Serial Number is A5EE:E414 
Directory of C:\temp 



8-02-93 


9:46a 


<DIR> 


0 . 


8-02-93 


9:46a 


<DIR> 


0 .. 


8-19-93 


11:07a 1483618 


0 IAW0S2BT.EMT 


8-19-93 


11:07a 


7787 


0 IAW0S2BT.REA 


8-19-93 


11:07a 


174 


0 IAW0S2BT.REL 


ftp> get 
200 Port 


5 file(s) 

tcpcl n 
request OK. 


1491579 bytes used 
5908992 bytes free 



125 Sending data set TCPIP.JCL(TCPCLN) FIXrecfm 80 

250 Transfer completed successfully. 

local: tcpcln remote: tcpcln 

2706 bytes received in 0.13 seconds (21 Kbytes/s) 

ftp> Idir 

The volume label in drive C is 0S2. 

The Volume Serial Number is A5EE:E414 
Directory of C:\temp 
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8-02-93 


9:46a 


<DIR> 


0 




8-02-93 


9:46a 


<DIR> 


0 




8-19-93 


11:07a 


1483618 


0 


IAW0S2BT.EMT 


8-19-93 


11:07a 


7787 


0 


IAW0S2BT.REA 


8-19-93 


11:07a 


174 


0 


IAW0S2BT.REL 


8-23-93 


3:45p 


2707 


0 


tcpcln 




6 file(s) 


1494286 bytes used 



5905408 bytes free 



ftp> quit 

221 Quit command received. Goodbye. 

[C:\] 

VSAM data sets will be reported with DSORG VSAM in a DIR listing, but you 
cannot do anything useful from FTP with VSAM. FTPSERVE in MVS will report 
Directory name matches a VSAM data set. 

MVS TCP/IP has no REXEC server, but the FTP server on MVS allows sending 
JCL to the internal reader. With this feature a kind of RJE for TCP/IP can be 
used as in the following example for JCL for MVS (file iefbr14.jcl): 

//WTCR17A JOB 'R. Traber', 

// USER=WTCR17,PASSW0RD=GEHEIM 

//S001 EXEC PGM=IEFBR14 

The example below shows an FTP session with MVS18. It uses the site 
filetype=jes2 subcommand to indicate that the file sent is not a file. The FTP 
server on MVS is used to transfer and execute a batch job on the MVS system 
The individual SPOOL files can be received with the get subcommand of FTP. 
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/ \ 
[E:\bookmaster\os2]ftp mvsl8 
Connected to mvsl8.itsc.raleigh.ibm.com. 

229-FTPSE18 at RAIANJE.ITSC.RALEIGH.IBM.COM, 18:39:48 on 11/19/91 
220 Connection will close if idle for more than 5 minutes. 

Name (mvsl8): wtcrl7 
331 Send password please. 

Password: 

230 WTCR17 is logged on. 
ftp> site filetype=jes 
200 Site conmand was accepted 
ftp> put iefbrl4.jcl 
200 Port request OK. 

125 Storing data set WTCR17.IEFBR14.JCL 
250 Transfer completed successfully, 
local: iefbrl4.jcl remote: iefbrl4.jcl 
100 bytes sent in 0 seconds (0 Kbytes/s) 
ftp> dir 

200 Port request OK. 

125 List started OK. 

WTCR17A JOB01476 OUTPUT 0 Spool Files 
250 List completed successfully. 

52 bytes received in 0.13 seconds (0 Kbytes/s) 
ftp> get job01476.1 
200 Port request OK. 

125 Sending data set WTCR17.WTCR17A.JOB01476.D0000002.JESMSGLG 

250 Transfer completed successfully. 

local: job01476.1 remote: job01476.1 

2199 bytes received in 0.094 seconds (22 Kbytes/s) 

ftp> get job01476.2 

280 Port request OK. 

125 Sending data set WTCR17.WTCR17A.JOB01476.D0000003.JESJCL 

250 Transfer completed successfully. 

local: job01476.2 remote: job01476.2 

276 bytes received in 0 seconds (0 Kbytes/s) 

ftp> get job01476.3 

200 Port request OK. 

125 Sending data set VnXR17.WTCR17A.JOBG1476.D0000004.JESYSMSG 

250 Transfer completed successfully. 

local: job01476.3 remote: job01476.3 

475 bytes received in 0.032 seconds (14 Kbytes/s) 

y 



4.2.7 FTP to/from DOS 

You can transfer files to and from DOS using either FTP, TFTP or FTPPM. The 
IBM TCP/IP V2.1 for DOS product offers you FTP and TFTP clients, an FTP server 
called FTPD, and an FTP client for Windows 3.1 called WFTP. The use of the 
FTPD server depends of the RAM memory your workstation has. 

FTP is a full-screen FTP client which includes FTP subcommands similar to the 
OS/2 FTP client. WFTP is a Windows 3.1 FTP client similar to FTPPM. The FTP 
server (FTPD) is a dedicated (foreground process) FTP server which can be 
interrupted to access a DOS command shell. FTPD also uses a TRUSERS 
(trusted users) file in the \TCPDOS\ETC directory similar to the OS/2 FTP server. 

The following shows an FTP session between an OS/2 client and a DOS server: 



SO TCP/IP V2.0 for OS/2 





OS/2 Ctrl ♦Esc = Uindou List 

[C:\tcpip\tmp] ftp dos2Q 
[Connected to dos20. 



Type HELP = help 



220 00S20 FTP server (2. 1.0.3) ready. 
Name (dos20): martin 
331 Password required for martin. 
Password: 



220 User martin logged in. 
ftp> pwd 

257 M C:\” is current directory. 

ftp> get CONFIG. SVS 

200 PORT command successful. 

150 Opening ASCII mode data connection for CONFIG.SYS (639 bytes). 

226 Transfer complete. 

local: config.sys remote: CONFIG.SYS 

639 bytes received in 0.047 seconds (13 Kbytes/s) 

ftp> dir d*. 

200 PORT command successful. 

150 Opening ASCII mode data connection for d*. . 

0 DIR 11-12-91 08:13 DOS 

226 Transfer complete, 
remote: d*. 

57 bytes received in 0 seconds (0 Kbytes/s) 
ftp> _ 



° :□ 



Figure 71. FTP Session from OS/2 to DOS 

For more details about the DOS FTP client and server, please see the IBM 
TCP/IP 2.1 for DOS product documentation. 

4.2.8 FTP to/from OS/2 

You can use either FTP, FTPPM or TFTP to transfer files from one OS/2 
workstation to another. 

If you use the OS/2 FTP client and create a NETRC file it is possible to define 
macros within that file. The following shows the NETRC file on machine martin: 

machine cidserver login martin password martin macdef rextest 

bell 

prompt 

status 



The keyword macdef implies the following is a macrodefinition. The macro is 
called rextest and contains the commands bell, prompt and status. The 
following screen shows the execution of this NETRC file with the host cidserver 
and macro rextest: 
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[C : \]f tp cidserver 
Connected to cidserver. 

220 cidserver FTP server (IBM OS/2 TCP/IP FTP Version 1.2) ready 
331 Password required for martin. 

230 User martin logged in. 

ftp> $rextest 

bell 

Bell mode on. 
prompt 

Interactive mode off. 
status 

Connected to cidserver. 

No proxy connection. 

Mode: stream; Type: ascii; Form: non-print; Structure: file 

Verbose: on; Bell: on; Prompting: off; Globbing: on 

Store unique: off; Receive unique: off 

Case: off; CR stripping: on 

Ntrans: off 

Nmap: off 

Hash mark printing: off; Use of PORT cmds: on 
Macros: 

rextest 

ftp> 



To execute the macro you have to enter it in the form $ftpmacro at the ftp> 
prompt. To make the FTP server interpret your macro correctly, you must use 
two consecuritve CR/LF (carriage return/line feed) sequences in the NETRC file 
to mark the end of the macro. 

4.2.9 FTP to/from OS/400 

OS/400 directories contain folders. The current directory after the user has 
issued an FTP logon is the QGPL library. 

The following figure shows a directory listing of an OS/400 library using the OS/2 
FTP client: 
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OS/2 Ctrl ♦Esc = Ulndow List Type HELP ? help 

[C:\tcplp\tmplftp as4QQ 
Connected to ralyas4b. k 

20-QTCP at RALYAS4B.ITS€.RALEl£H.IBH.CQM. 

20 Connect ion will close if idle wore than 5 minutes, 
awe (as400): martin 
331 Enter password. 

Password: 

230 MARTIN logged on. 
ftp> pwd 

257 M QGPL W is current library. 
ftp> cd martin 

250 Current library changed to ftfBHTN. 
ftp> dir 

200 PORT subcommand request successful. 

125 List started. 

MRRTIN 2560 CONFIG.SYS 

MARTIN 40960 CONFIG 

250 List completed successfully. 

144 bytes received in 0 seconds (0 Kbytes/s) 
ftp> 



Figure 72. Displaying the Contents of an OS/400 Library Using FTP 



Note: When you access and AS/400 system with FTP you only have access to 
OS/400 library objects, not to shared folders used by PC Support! 

The following shows an FTP session from an AS/400 system to an OS/2 FTP 
server, listing an OS/2 directory, and transferring the PROTOCL.INI file back from 
the AS/400 to OS/2: 




Hark -^Configuration iFonts : Exit 



murl i. 

>>>USER murl 1 

331 Password required for nurl i, 

>>>PASS +*-H+fr++ 

230 User murli logged in. 

Enter an FTP command. 

pwd 

»>PUD 

257 M C:V is current directory. 

Enter an FTP command, 
cd ibmcom 
>>>CU0 ibmcom 

250 CUD command successful. 

Enter an FTP command, 
get protocol.ini 
»>P0RT 9,67,38,83,3,236 
280 PORT command successful . 

>>>raETR protocol . ini 

158 Opening ASCII mode data collection for protocol.ini (1473 bytes). 
226 Transfer complete. 

1472 bytes transferred in 3,198 seconds. Transfer rate ,461 KB/sec, 
Enter an FTP command. 



° O 



Figure 73. Transferring a File from OSI400 to OS/2 Using FTP 
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4.2.10 FTP to/from DEC/VMS 

The following example shows an FTP session between an OS/2 system and a 
DEC MicroVAX running VMS and MultiNet: 



\ 

[C:\tcpip\tmp]ftp dec 
Connected to dec. 

220 dec MultiNet FTP Server Process 3.2(14) at Wed 25-Aug-93 5:50PM-EOT 
Name (dec): system 

331 User name (system) ok. Password, please. 

Password: 

230 User SYSTEM logged into SYS$SYSR00T:[SYSMGR] at Wed 25-Aug-93 17:51, job 59. 

ftp> led c:\ 

Local directory now C:\ 
ftp> put config.sys 

200 Port 4.14 at Host 9.67.38.81 accepted. 

150 ASCII Store of SYS$SYSR00T:[SYSMGR]C0NFIG.SYS;1 started. 

226 Transfer completed. 4112 (8) bytes transferred, 
local: config.sys remote: config.sys 
4112 bytes sent in 0.062 seconds (64 Kbytes/s) 
ftp> get startnet.log 

200 Port 4.16 at Host 9.67.38.81 accepted. 

150 ASCII retrieve of SYS$SYSR00T:[SYSMGR] STARTNET.LOG; 7 started. 

226 Transfer completed. 9329 (8) bytes transferred, 
local: startnet.log remote: startnet.log 
9329 bytes received in 0.16 seconds (58 Kbytes/s) 
ftp> 



To see whether the CONFIG.SYS file arrived properly, it was loaded into an 
editor on the DEC using the following command: 

et config.sys 

The following picture shows the DEC editor with that file in an OS/2 TelnetPM 
session: 




IFS=C:\OS2\HPFS.IFS .'CACHE : 1024 /CRECL:4 /AUTOCHECK ;C 

PROTSHELL=C : \0S2\PMSHELL . EXE 

DEVICE =C : \ IBMCOM\PROTOCO L\ LANPDD . OS 2 

DEVICE=C : \ I BHCOMnPROTOCO L\ LAHVDD . OS 2 

DEVICE=C : n0S2\ IAOS2RFS . SYS 

SET USER_INI=C i\OS2\OS2.INI 

SET SYSTEM_INI=C : \OS2\OS2SYS . INI 

SET 0S2_SHELL=C: \0S2\CHD.EXE 

SET AUT0START=PR0GRAMS .TASKLIST, FOLDERS 

SET RUHWORKPLACE=C : \0S2\PhSHELL.EXE 

SET C0HSPEC=C: \0S2sCHD.EXE 

set restartobjects=startupfoldersonly 

LIBPATH=C : \ IBMCOM\DLL; C : \NBTCP ; C : \ IBMLANMfETLIB ; C : sMUGLIBvD LL; . C : \OS2\D LL; C : \C 
SET PATH=C : nIBHLAN\HETPROG ; C : \OS 2 ; C : \CMLIB : C : sMUGLIB ; C : n 0S2\SYSTEH : C : \OS2\MDOSv 
SET DPATH=C : MBMCOM ; C : \ IBHLAN\NETPROG; C : \ IBMLAN ; C : \0S2 ; C : \CMLIB j C : \MUGLIB\D LL ; C • 
SET PR0MPT=Si [Sp] 

SET HELP=C : \OS2nHELP ; C : \ 0S 2\HELPx TUTORIAL j C : sCMLIB ; C : sTCPIPvHELP ; 

SET GLOSSARY=C:sOS2\HELP\GLOSS; 

SET IPF_KEYS=SBCS 
PRI0RITY_DISK_I0=YES 
autofail^yes 



Buffer : COHFIG . SYS ^ ■ 1 Write ]■ Insert | Forward 



|125 lines read from file SYSSSYSROOT: [SYSHGRlCONFIG -SYS ; 1 
Figure 74. DEC ET Editor with OS/2 CONFIG.SYS File 
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The following example shows an FTP session between a DEC MicroVAX and an 
OS/2 system: 



$ multi net ftp cidserver 

dec MultiNet FTP user process 3.2(106) 

Connection opened (Assuming 8-bit connections) 

<cidserver TTP server (IBM OS/2 TCP/IP FTP Version 1.2) ready. 
CIDSERVER>user 
Foreign username: martin 
<Password required for martin. 

Password: 

<User martin logged in. 

CIOSERVER> 

CIDSERVER>pwd 

is current directory. 

CIDSERVER>cd d: 

<CWD comrand successful. 

CIDSERVER>dir 

<0pening ASCII mode data connection for D:\. 



5 


DIR 


07-14-93 


14:01 




5 


DIR 


07-14-93 


14:01 


# . 


0 


DIR 


08-04-93 


13:46 


book 


0 


DIR 


08-18-93 


08:55 


cid 


0 


DIR 


07-19-93 


10:00 


CMLIB 


0 


DIR 


07-22-93 


09:53 


doc 


0 


DIR 


08-05-93 


15:12 


IBMLAN 


0 


DIR 


08-05-93 


13:21 


oldcid 


0 


DIR 


08-23-93 


16:23 


oldlaps 


0 


DIR 


08-23-93 


16:19 


oldtcp 


0 


DIR 


07-20-93 


12:36 


swapper 


0 


DIR 


07-19-93 


10:15 


TCPIP 


0 


DIR 


07-28-93 


17:41 


tools 



<Transfer complete. 

CIDSERVER>quit 

<6oodbye. 

$ 



4.2.11 Multiple FTP Sessions from a Single OS/2 Client 

It is possible to have multiple FTP sessions at the same time from one OS/2 
workstation. You use FTPPM to establish all sessions and then switch back and 
forth among them. The following figure shows the connection list from which to 
choose a host for file transfer: 
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j^ongj^tlons '' [Update V Quicktra ns ^Hetp '£ 




LOCAL 

Local Directory is: 
[C:\fcPIP\TMP 



Local File Mask: 



!*.* 



dos20 (martin) 
Remote Directory 



|C:\ 



Remote File Mask: 



PMGRAB0O.PSE 



I irrAntlHnc 







martin (murli) 
vm (tcpipl) 
dos20 (martin) 



m 




13 DOS 
15 CMD 
10 SP00 
23 CONF 









tcpdB 




06-30-93 14:24 


psrdI 


■BflHHI 









Figure 75. Multiple FTP Sessions with FTPPM 



4.3 Trivial File Transfer Protocol (TFTP) 

TFTP is an alternative to transferring files with the FTP. TFTP is a simple file 
transfer protocol and does not provide all of the features available in FTP. TFTP 
uses User Datagram Protocol (UDP) as the underlying protocol; therefore, it is an 
unreliable means of file transfer. 

TFTP is implemented in TCP/IP V2.0 for OS/2 with both client and server support. 
You can start TFTP using either the INETD super server or start TFTP from an 
OS/2 command prompt in an OS/2 window. 

Notes: 

1. Only one TFTP server can run on a PC at one time. 

2. There is no security for access to TFTP servers. When the TFTPD server is 
running on your PC, other users in the network can read, write, or even 
destroy the files on your machine. 

The following screen shows the subcommands available for TFTP: 
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( 






tftp> ? 

Corrcnands may be abbreviated. Commands are; 




connect 


connect to tftp server 




mode 


set file transfer mode 




put 


send file 




get 


receive file 




quit 


exit tftp 




verbose 


toggle verbose mode 




trace 


toggle packet tracing 




status 


show current status 




bi nary 


set mode to octet 




ascii 


set mode to netascii 




rexmt 


set per-packet retransmission timeout 




timeout 


set total retransmission timeout 




? 


print help information 




tftp> 




J 



4.4 Using FTP from OS/2 CMD Files 

The following examples of OS/2 CMD files show how FTP can be called from 
within such a file: 

FTPPUT1.CMD (Prompt for Password) 

@echo off 

rem usage: ftpput <host> <loca1 file> <remote file> 

rem password will be prompted if a NETRC-file is not used 

rem no blank allowed between user name and redirect operator 

rem remove next statement if a NETRC-file is used 

echo paul < ftp. in 

echo put %2 %3 » ftp. in 

echo quit » ftp. in 

ftp HI < ftp. in 

if errorlevel 1 goto end 

echo File H2 transferred to HI 

&end 

erase ftp. in 

FTPPUT2.CMD (No Prompt for Password) 

@echo off 

rem usage: ftpput <host> <local file> <remote f i 1 e> 

echo open %1> ftp. in 

echo user paul password » ftp. in 

echo put %2 %3 » ftp. in 

echo quit » ftp. in 

ftp -n < ftp. in 

if errorlevel 1 goto end 

echo File %2 transferred to HI 

&end 

erase ftp. in 

The following shows an example of running FTPPUT1.CMD with prompt for 
password: 
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Type HELP = help 



OS/2 Ctrl+Esc = Task List 
[C : \W0RK2] f tpputl os25 ftptst.tst c:\work\testl.txt 
Name (os25): Password: 

File ftptst.tst transferred to os25 

[C:\W0RK2] 

This example can also be executed from Presentation Manager by defining a 
program in Presentation Manager: 

Program title: FTPPUT 

Path and filename: c:\work2\ftpputl.cmd 

Parameters: [Enter <host> <local file> <remote file>] 

Working directory: c:\work2 
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Chapter 5. Remote Printing 



TCP/IP V2.0 for OS/2 offers you the possibility to print jobs on remote printers, 
and to receive jobs from remote systems to your printer in a TCP/IP network 
environment. The following modules provide remote printing functions: 



Module 


Remote Printing Function 


Ipd 


Line Printer Daemon (Server) 


Ipr 


Line Printer (Client) 


Iprmon 


Line Print Monitor 


Ipq 


List jobs in remote queues 


Iprm 


Remove jobs from remote queues 


Iprportd 


Enable the use of port objects in the OS/2 Workplace Shell 



5.1 TCP/IP V2.0 for OS/2 Remote Printer Server LPD 

LPD is a line printer server that allows clients to print files into a queue defined 
in the Print Manager. When a client sends a print request to LPD, it should 
specify the queue that it wants the file to be printed in. LPD will also accept a 
device name {for example, LPT1), and try to determine the first queue that is 
attached to that device. 

5.1.1 File Format Types 

When LPD receives a print job, the client can specify that the file is of a 
particular format via special codes in the control file that are passed along with 
the print job. LPD understands two types of formats, and the user can have 
either as the default. If a client notifies LPD that the file being printed is a binary 
file, then LPD will put exactly what is sent into the corresponding queue to be 
printed. If a client notifies LPD that the file being printed is a plain text file, then 
LPD will convert LF (line feeds) to CRLF {carriage return, line feed) pairs. 

By default, if a client sends a file to LPD, and does not specify one of the known 
file types of binary or text, then LPD will default to assuming that the file is 
binary. If for some reason when you try to print a file to the OS/2 LPD, it prints 
diagonally across the page {that is, missing carriage returns to put the next line 
at the left margin), then you probably want LPD to default to assuming that the 
file it receives without a known type is of type TEXT {and therefore LPD will do 
the LF to CRLF conversion). This can be done by specifying the -f option on the 
LPD command line. 

5.1.2 LPD Banner Page 

Along with being able to disable the default banner page, users can also specify 
their own banner page. A user does this by specifying a file name along with 
the -b option on the LPD command line. Whenever a print request comes in, 

LPD will print the specified file as the banner page. If you do not specify a file 
name with the -b option, there is no banner printed. 

The following is a list of keywords that can be specified in the banner file, and 
which are replaced with their corresponding value upon printing: 
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Keyword Description 

%H% Name of the host that originated the print job 

%U% Name of the user that originated the print job 

% J% Name of the print job 

%C% Class of the print job 

The default banner page looks like the following: 



L 
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N N N 


EEE 


RRR 


L 


P 


D D 


B B 


A A 


N NN 


N NN 


E 


R R 


LLLLL 


P 


DDD 


BBB 


A A 


N 
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N 
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Host := %H% 

User := %U% 

Job := %J% 

Class: s %C % 

J 



5.1.3 LPD Control File 

This file contains spooler, queue, and network options for each job, and some 
additional control parameters for the LPD server. It can optionally be printed 
with each job. 



5.1.4 LPD Usage 

The format of the LPD command is as follows: 



lpd -? | {[-c] [-b [<banner>]] [-s] [-f]} 

where banner - Optional file containing 
the banner to be printed 



Options 



.? 



-c 

-b [<banner>] 



-s 

-f 



This message 

Do not print control file 

If a <banner> file is supplied, 
then use that file as the Banner. 
Otherwise no banner is printed. 
Secure (720 < client_port < 732) 
Default to TEXT file format. 



Note: If you use INETD to start the LPD server, you cannot define start 

parameters to the LPD command. Therefore you should start the LPD 
server in a foreground window. 

The following shows the status screen of the OS/2 LPD server: 
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Line Printer Daemon (LPD) 

(C) Copyright IBM Corp. 1991 



Version: 1,2.1 
Created: Feb 23 1993 
Tine: 16:00:19 



[Print request from murhann$nartin for file C:\C0NFIG.SYS received. 
■Print request from nurhann@mart in for file C:\C0NFIG.SYS printing. 



Figure 76. OS/2 LPD Server 



5.2 Remote Printer Client LPR 

The LPR command is used to explicitly send a file to a remote printer. If you 
need to send several files you would have to issue as many LPR statements as 
files to be printed. 

Note: If the files you like to send to a printer can be specified using wildcards 
('*" or LPR will accept that. 

You do not have to specify the remote printer with any job if the environment 
variable LPR_PRINTER is set. This is usually the case if you have configured a 
remote print server in the TCP/IP Configuration Notebook. 

The following example would send the CONFIG.SYS file to the remote printer 
LPT1 at host OS25: 



'i 

[C:\]lpr -p lptl -s os25 config.sys 

Printing C:\CONFIG.SYS: 

Trying LPD print server os25(9. 67.38. 69), device lptl. 

Sent 3746 bytes. 

The entire document was sent. 
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5.3 Remote Printer Monitor LPRMON 

The LPRMON function allows you to redirect the output of a parallel printer port 
from your PC to a network host that provides the LPR server function. This 
allows you to print to an LPR server without an application using the Line Printer 
protocol directly. Refer to the TCP/IP V2.0 for OS/2 User's Guide for more details 
about the LPRMON parameters. 

This is very convenient for workstations without an attached printer, or for 
workstations that use remote printers from servers of different architectures such 
as IBM OS/2 LAN Server V3.0 or Novell NetWare. To redirect all printer output 
on the local LPT2 port to the OS/2 printer LPT1 on host OS25, enter the following 
command: 

start lprmon -p lptl -s os25 lpt2 

Now, all output sent to the LPT2 device is redireced to the remote OS/2 printer. 

In this case, the command to send CONFIG.SYS is simply: 

copy config.sys lpt2 

The following shows how LPRMON would react on sending a file to the remote 
printer. 



Job 
CONFIG.SYS 



Status 
-printing 



Info 
3746 bytes 



;LPR Monitor for \dev\lpt2, server os25, printer lptl. 



Figure 77. Remote Printing using LPRMON 

Note: LPRMON only allows the redirection of parallel ports LPT1 to LPT3. 



5.4 Workplace Shell Integration of Remote Printing 

With TCP/IP V2.0 for OS/2 printing has become easier than just redirecting a 
parallel port to a remote printer. Now you can redirect a printer object from the 
OS/2 Workplace Shell to a remote LPD printer. You can then select this printer 
from any Presentation Manager application as it appears in the list of available 
printers. Thus, you are no longer restricted to only three remote printers, as 
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was the case with LPRMON. To use the Workplace Shell redirection method 
called the LPR Port driver, create a new printer from the Templates folder, or 
open the settings from an existing printer object. 

Note: You cannot use a network printer object for the LPR port driver since LPT 
port does not work with the LAN-aware Shell like IBM OS/2 LAN Server 
V2.0, IBM OS/2 LAN Server V3.0, or Novell NetWare Requester for OS/2. 

On the TCP/IP V2.0 for OS/2 configuration notebook setting for Services, you can 
specify a maximum number of LPD ports. The default is 8, and the name of an 
LPD port is \PIPE\LPDn, where n is the number of the port beginning with 0. 
These LPD ports appear in the output page of a printer object settings notebook 
after the parallel (LPT) and serial (COM) ports to which a printer can usually be 
connected. 

The following shows connection icons for a Workplace Shell printer including 
LPR ports: 




Figure 78. Connecting a Printer Object to an LPR Port 

To connect an OS/2 printer to an LPR port, simply double-click on the port icon 
that you want to use for the printer in question. 

The following shows the configuration menu for an LPR port: 
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Figure 79. Configuration of an LPR Port 



Menu 

LPD Server 
LPD Printer 
Hostname 
User 
Spooler 

Queue 

Network 

Print Dialog 
Send Mail 



Print Banner 
Control Cards 



Setting 

Specifiy the LPD server where jobs are to be sent for printing 

Specify which printer to use on the above server 

Specify the local host where print jobs originate 

Specify the user name at the above host 

Send spooler parameters to the CONTROL file at the remote 

server 

Send queue parameters to the CONTROL file at the remote 
server 

Send network parameters to the CONTROL file at the remote 
server 

Display this menu every time before printing a job 
Send a reply when a job has finished. This option is not 
supported by the OS/2 LPD server which means that an OS/2 
LPD server will not notify a user upon completion of print jobs. 
Print a banner file with the optionally specified classification 
Send additional control information. 



For a more complete discussion of LPR port settings, please refer to the TCP/IP 
V2.0 for OS/2 User's Guide. 



The following shows how to print the CONFIG.SYS file using the OS/2 Workplace 
Shell. The file object CONFIG.SYS is dragged from the Directory folder onto the 
printer object using the right mouse button. Once the button is released, the file 
will print to the remote printer LPR Printer. 
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Figure 80. Printing to an LPR Port 



— Important Notice 

Before you can actually print to printers connected to LPR ports, you must 
start the LPRPORTD server. See the next section about LPRPORTD. 

You cannot print to LPR ports from WIN/OS2. Therefore, for WIN/OS2 
applications you must still use LPRMON. 



5.5 The LPR Port Driver 

The LPRPORTD acts as the server for objects connected to remote printers via 
LPR port icons. This server must be started as a separate task before LPR port 
printers can be used. If LPRPORTD is not started you will receive a message 
that the remote printer is not online. 

To start LPRPORTD, simply enter the following command: 
start lprportd 



5.6 Remote Printing from UNIX to OS/2 

To use an OS/2 printer from an AIX, use SMIT to set up a remote printer queue. 

Output from AIX command can now be directed to the OS/2 printer. Note that 
there is no security mechanism in OS/2; any workstation can use an OS/2 LPD 
print server's printers). 

The following shows how a remote print queue is defined to AIX using SMIT: 
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•iSession pEdit alCommands llOptidns IjSHel p 'fiff |i§||| 



Change / Show Characteristics of a Queue 

Type or select values in entry fields. 

Press Enter AFTER making all desired changes. 



Name of Queue 

ACTIVATE the queue? 

ACCOUNTING FILE pathname 

DESTINATION HOST for remote jobs 

Pathname of the SHORT FORM FILTER for queue 
status output 

Pathname of the LONG FORN FILTER for queue 
status output 

Name of QUEUE on remote printer 



[Entry Fields] 
os25 

first come first serve 
yes 

[FALSE] 

-[9.67.38.69] 

[/usr/ Ipd/aixshort ] 

[/usr/lpd/aixlong] 

[Iptl] 



FUHelp 
Esc* 5= Undo 
F9=Shell 



F2=Refresh 
F6 = Command 
F10=Exit 



F3= Cancel 

F7=Edit 

Enter=Do 



Figure 81. Configuration of a Remote Print Queue to A!X 



F4=List 
F8 linage 



Make sure that the OS/2 spooler and the TCP/IP server LPD are running in OS25 
before you start printing. 

The following picture shows sending a print job from AIX using SMIT. The file to 
be printed is /home/martin/config.sys on LPD server OS25 and its printer LPT1: 



Figure 82. 




Start a Print Job 



Type or select values in entry fields. 

|Press Enter AFTER making all desired changes. 

[TOP] 

♦ FILE to print 



PRINT QUEUE: [Queue Device] 



NUMBER of copies 
Make a COPY of the file on the local host? 

(Applicable to local print jobs only.) 

ERASE the file from the system after printing? 
Send notification of job status? 

BURST status 

USER NAME for 'Delivery to' output label 
CONSOLE acknowledgement message for 
remote print 

FILE acknowledgement message for 
remote print 
Priority LEVEL. 

[MORE... 4] 



Fl=Help 

Esc+5=Undo 

F9=Shell 



F2=Refresh 
F6= Command 
F10=Exit 



F3= Cancel 

F7=Edit 

Enter=Do 



[EntryFields] 

[ BSStBiBSIB l 

rliBSEff 

[i] 

no 

no 

no 

no burst pages 
[] 

[] 

[] 

[15] 



F4=List 

F8=Image 



AiX SMIT Remote Print on OS/2 LPD Server 
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5.7 Remote Printing from OS/2 to UNIX 

To make an AIX LPD print server accept your OS/2 print jobs, your host name 
must be specified in the /etc/hosts and /etc/hosts.lpt files on the AIX system. 



To print to the AIX printer, you have the following options: 

• Explicitly use the LPR command 

• Use LPRMON 

• Use an LPR port printer 

The following shows the print queue asc on the AIX system rs60007 after having 
been accessed by either method mentioned above (jobs 4, 5, 6): 







1 - Session jSEdit^ilCbmmands iiOptions SiHelp 



COMMAND STATUS 

(Command: QQ stdout: yes stderr: no 

(Before command completion* additional instructions may appear below. 



Queue 


Dew 


Status 


Job Files 


User PP Z 


Blks 


Cp Rnk 


asc 


IpO 


DO UN 
QUEUED 


2 config.sys 


martin 


4 


1 1 






QUEUED 


4 C:\C0NFIG.SYS 


murhamn@ma 


4 


1 2 






QUEUED 


5 CONFIG. SYS 


murhamn$ma 


4 


1 3 






QUEUED 


6 AUTOEXEC.BAT 


< unknown^ 


8 


1 4 



I F1 =Help 
F8= Image 



F2=Refresh 

F9=Shell 



F3=Cancel 

FlQ=Exit 



F6= Command 



Figure 83. AIX Print Queue with OS/2 Print Jobs 



5.8 Remote Printing to/from VM 

TCP/IP for VM has implemented an LPD server function. All the printers 
available to VM can be used from a TCP/IP LPR client. In the example scenario 
we used one 3287 printer for TCP/IP output. 

Note: Only simple, line-oriented text (no graphics) can be printed out on such a 
connection. 

The printer on the VM system has to be defined in the VM LPSERVE virtual 
machine. Our printer is available via RSCS, and the definitions are shown in the 
example LPD CONFIG file on System VM14. 
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SERVICE JULIO PRINTER 
RSCS SPOOL=TO RSCSV2 
TAG=PRT3287 
FILTERS f 1 p 
LINESIZE 132 
PAGESIZE 66 
OBEY TCPMAINT 
;DEBUG 

The Ipr command on OS/2 allows you to print a text document on a remote 
TCP/IP system that runs an LPD server. An OS/2 file can be printed on the VM 
printer with the following command: 





[C:\]lpr config.sys -p JULIO -s vml4 

Printing C:\config.sys: 

Trying LPD print server vml4.itsc.raleigh.ibm.com(9.67.32.18), device JULIO. 

Sent 2668 bytes. 

The entire document was sent. 

[C:\] 

— 



To print the VM file all notebook a on the OS/2 LPD print server with the IP 
address 9.67.38.81 enter the command: 



Ipr all notebook a (PRINTER lptl HOST 9.67.38.81 
Ready; 

lpq (PRINTER lptl HOST 9.67.38.81 

JobID File Name Rank Size Status 



7 ALL. NOTEBOOK 1 1671 Printing TCPMAINT6RALYESA 



The LPQ command shows you the status of the print job in the print queue. 



5.9 Remote Print from DOS to OS/2 

Set the DOS environment variables: 

• LPR_PRINTER = lptl through Ipt3 

• LPR_SERVER = IPaddress or host_name. 

on the DOS workstation to define a default printer. 

You can now print files on a printer connected to the OS/2 workstation by 
entering lpr file name at the DOS command prompt. If you want to use another 
print server in the network, you can use the lpr command as described in the 
IBM TCP/IP for DOS User's Guide. For example, to print the file AUTOEXEC.BAT 
on the LPT1 printer of the print server OS25 enter the command: 

lpr -p lptl -s os25 autoexec.bat 
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5.10 The LPQ Command 

To query jobs that are in the queue on a remote print server attached to the 
network, use the LPQ command. To see, for instance, how well the jobs from the 
sections before printed on printer LPT1 on host OS25, enter: 

Ipq -p Iptl -s os25 

The results are taken from the OS/2 print manager for that queue (printer object) 



and may look like this: 
JobID File Name 


Rank 


Size 


Status 


Comment 


4 


CONFIG.SYS 


1 


5336 


Form Change 


martin@martin 


5 


C 


2 


2197 


Form Change 


martingmartin 


6 


config.sys 


3 


3861 


Printing 


root@rs60007 



Notes: 

1. The first job (4) was the CONFIG.SYS file dragged from the Drives folder to 
the printer object. 

2. The next job was a print-screen from a host session of IBM Communications 
Manager/2 VI .0. 

3. Jobs 4 and 5 have a problem with the paper form which needs to be checked 
in the object settings on the LPR port printer at the client. 

4. Job 6 was printed from an RS/6000. 



5.11 The LPRM Command 

This command is used to remove jobs from a remote printer queue. You can 
first use LPQ to see what jobs actually are in the queue, then select a job to 
remove by its job number (JobID). To remove, for instance, the jobs from the 
section above which did not print on printer LPT1 on host OS25, enter: 

lprm 4 5 -p lptl -s os25 
The results may look like this: 



JobID 


File Name 


Rank 


Si ze 


Status 


4 


CONFIG.SYS 


1 


5336 


-removed 


5 


C 


1 


2197 


-removed 
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Chapter 6. Remote Execution of Commands 



This chapter describes the facilities of TCP/IP V2.0 for OS/2 to execute 
commands on remote TCP/IP systems. TCP/IP V2.0 for OS/2 gives you the 
server and client functions of: 

• REXEC (Remote Execution) 

• RSH (Remote Shell) 

Both programs are similar because you have authorized security on a remote 
host. However, they differ in the authorization scheme. 

The REXEC server (REXECD) serves any client that can correctly specify an 
existing account and the account password on the server machine. The OS/2 
REXECD reads user ID and password values from the environment variables 
USER and PASSWD. 

RSH reads a list that identifies the user on a specific remote client that has the 
same privileges as a particular server user. No password is required. The OS/2 
RSH server (RSHD) reads the RHOSTS file in the \TCPIP\ETC directory. This file 
contains host names and users on those hosts that are authorized to access the 
server. 



6.1 REXEC 

The REXEC client can be used to execute commands on systems running the 
REXECD. Multiple commands can be entered by separating them with the 
operator and enclosing the commands in double quotes. On VM systems, 
multiple commands can be entered by separating them with a semicolon (;). 

6.1.1 Sample NETRC Files 

To minimize the input at the command line, you can create a NETRC file. The 
login and password values are used by the REXEC command to log in to a 
foreign host using these values. The values defined in the NETRC file must 
match the environment variables USER and PASSWD defined on the foreign host. 
These values are case sensitive. 

A description of the input to the NETRC file may be found in the TCP/IP V2.0 for 
OS/2 User's Guide. 

We used the following NETRC on host martin: 

machine martin login martin password martin 
machine rs60007 login martin password martin 
machine ralyas4b login martin password martin 

Note: This file, if it exists, is also used by the OS/2 FTP clients to logon to 
remote hosts automatically. Users have to make sure that login and 
password values in the local NETRC file match the following on the 
remote hosts specified by the machine tag: 

• USER and PASSWD environment variables for REXEC 

• User and password set for the user tag in the TRUSERS file for FTP. 



<£> Copyright IBM Corp. 1990 1992 1993 



in 



If you do not want to specify these variables in the CONFIG.SYS file 
for security reasons, you must specify these variables at the OS/2 
command prompt where you will start REXECD. You can also start 
the REXEC server using INETD. 



The following command, issued from AIX, will change the current directory to 
\TCPIP\ETC, then list the contents of the directory and of the file TRUSERS: 

rexec martin "cd \tcpip\etc & dir & type trusers" 

The output from this command is displayed in the REXECD server window before 
it is actually sent to the client. 

The OS/2 REXECD uses the environment variables USER and PASSWD to 
validate a request. Note that the values entered for these variables are case 
sensitive. 



6.2 REXEC from DOS to OS/2 

Set the following DOS environment variables on the DOS workstation: 

USER User ID for REXECD in the OS/2 system - Contents of the USER 
environment variable 

PWD Password for REXECD in the OS/2 system - Contents of the PASSWD 
environment variable 
REXEC IP address of the OS/2 system 

You can now enter rexec <0S/2 command> at the DOS command prompt to execute 
an OS/2 command on the OS/2 workstation. The following command will change 
the current directory to \TCPIP\ETC, then list the contents of the directory and 
the file TRUSERS: 

rexec martin -cd \tcpip\etc & dir & type trusers* 

The example shows the type of security issues one can face in allowing remote 
execution on an OS/2 workstation. 



6.3 REXEC from OS/2 to VM 

With the REXEC client in TCP/IP V2.0 for OS/2, the OS/2 user can execute VM 
commands. Multiple commands can be entered in one invocation by separating 
them with semicolons. Normal redirection in OS/2 can be used. The following 
command will list the assigned VM disks and the current time on the host 
wtcesa: 
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[C:\3rexec wtcesa -1 guest -p guest q disk;q t 



LABEL VDEV M 


STAT 


CYL TYPE BLKSIZE 


FILES 


BLKS USED- (%) BLKS LEFT 


BLK TOTAL 


REX191 191 


A 


R/0 


5 3380 4096 


2 


14-02 


736 


750 


TMT591 591 


E 


R/0 


40 3380 4096 


107 


3381-56 


2619 


6089 


TMN592 592 


F 


R/0 


75 3380 4096 


608 


7437-66 


3813 


11250 


S-DISK 190 


S 


R/0 


70 3380 4096 


290 


6833-65 


3667 


10509 


Y-DISK 19E 


Y/S R/0 


200 3380 4096 


1543 


19070-64 


10930 


38080 



TIME IS 10:57:47 EOT THURSDAY 07/02/92 

CONNECT® 00:03:00 VIRTCPU 3 000:00.29 TOTCPU= 800:00.43 



6.4 REXEC from MVS to OS/2 

With the REXEC client in MVS, commands can be executed on an OS/2 system 
running the REXECD of TCP/IP V2.0 for OS/2. The following command, issued on 
host mvs18sna, will list the contents of the C:\TCPIP\TMP directory on host 
martin: 



N 

READY 

rexec 9.67.38.81 dir c:\tcpip\tmp 
TCPREX630I userid (9.67.38.81:murhanm) 
martin 

TCPREX029I passwd (9.67.38.81;martin) 



The volume label in drive C is 0S2. 
The Volume Serial Number is A5EE:E414 
Directory of C:\tcpip\tmp 



7-16-93 


4:47p 


<DIR> 


0 


♦ 


7-16-93 


4:47p 


<DIR> 


0 


♦ • 


8-23-93 


3:23p 


171960 


0 


PMGRAB00.PSE 


8-23-93 


4:16p 


156228 


0 


PMGRAB01.PSE 


8-23-93 


4:53p 


206524 


0 


PMGRAB02.PSE 




5 file(s) 


534712 bytes used 



5520384 bytes free 



^ READY J 



6.5 REXEC between OS/2 and UNIX 

TCP/IP V2.0 for OS/2 supports both the REXEC client and the REXECD server. 
Thus, AIX users can execute commands on an OS/2 REXECD and OS/2 users 
can execute commands on an AIX REXEC server. The following screen shows 
an example of a remote command execution at host rs60007 from an OS/2 
REXEC client: 
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[C:\]rexec 


rs60007 Is 


-Is 












\ 


total 88 


















-rw-r--r-- 


1 martin 


staff 


3746 


Jul 


27 


13:87 


CONFIG.SYS 




-rw-r--r-- 


1 martin 


staff 


3746 


Jul 


27 


12:56 


config.sys 




-rw-r— r— 


1 martin 


staff 


31977 


Jul 


28 


15:49 


smit.log 




-rw-r— r— 


1 martin 


staff 


2787 


Jul 


28 


15:48 


smit. scrip 




[C:\] 

v 



















If you have the X Windows Server running on your OS/2 workstation, you can 
open an AIX command shell window on your desktop with the following 
command (rather than starting it from a Telnet session): 

rexec rs60007 aixtenn -d martin :0 

assuming that rs60007 is the AIX system where the X window is being sent from, 
and martin is your OS/2 system. 

You may have trouble with the backslash character in OS/2, when you execute 
an OS/2 command from certain UNIX workstation. This can be solved by 
enclosing the command in double quotes. The following sample shows the input 
of a rexec command at an AIX command prompt to be executed at OS/2 REXEC 
server martin : 



A 


N 


$ rexec martin "type c:\tcpip\etc\netrc" 
Name (marti n :marti n) : martin 
Password (mart in smart in): 




machine martin login murli password martin 
machine rs60007 login martin password svo07m 
machine ralyas4b login martin password martin 




> 


J 



6.6 Executing a Command on a Foreign Host - RSH 

To run the OS/2 RSHD server, an RHOSTS file must exist. This file can be 
created manually in the directory where the ETC environment variable points to, 
or by using the TCP/IP V2.0 for OS/2 Configuration Notebook. The RHOSTS file 
contains the fully qualified host names of the authorized client machines and if 
needed, the user names of the users who are allowed to use RSHD from that 
client machine. If no users are defined per machine, then every user that uses 
that machine has access to RSH services on the RSHD server. 

The RSHD server compares the hostname and user field in the request frame, 
sent by the RSH client, with the entries in the RHOSTS file. If they are identical, 
the remote machine and the remote user have access to RSHD services. 

The RHOSTS file on host martin could look like the following: 
miers scott 

In a network with a domain name server, the RHOSTS file would look like the 
following: 

rs60007 . i tsc . ral ei gh . i bin. com marti n 
os25. i tsc. ral ei gh . i bm.com 
dos20.itsc.raleigh.ibm.com 
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That means that every user on the hosts os25 and dos2D can execute commands 
on host martin. But only user martin at machine rs60007 can obtain RSH service. 
The entries in this file are case sensitive. 

The RSHD server can be started as an INETD subserver task or as a foreground 
task. 

The following example shows the RSH client on AIX requesting RSHD service on 
the OS/2 RSHD server martin: 



— \ 

<rs60807># rsh martin type c:\autoexec.bat 

0ECHO OFF 
ECHO. 

PROMPT $i$p$g 

REM SET DELDIR=C : \DELETE . 512 ; D : \0ELETE , 512 ; E : \0ELETE , 512 ; 

PATH D s \0S2 ; D : \0S2\MD0S ; D s \0S2\MD0S\WIN0S2 ;D : \ 5 

LOAOHIGH APPEND O:\OS2 ;0:\0S2\SYSTEM 

REM LOAOHIGH DOSKEY FINDFILE=OIR /A /S /B $* 

REM SET DIRCMD=/A 

<rs68007># 



A user on the AIX system rs60007 other than martin will get the following 
message: 



— 'I 

<rs60807># rsh martin type rhosts 

Unauthorized Request rejected. 

<rs60007># 



If a user name is defined for a host name in the RHOSTS file, the USER 
environment variable on that host has to be set to that exact value. Both values 
must match, even in length. 

If the USER environment variable at an OS/2 RSH clients set to blank (set user=), 
a default user name OS2USER is used instead. 

Note: There is no security when the RSHD server is running. If a remote user 
learns the host names in the RHOSTS file, that remote user can execute 
any commands on your workstation. If you have a TELNET, REXEC, TFTP, 
RSH, or FTP server running on your machine, and you have created a 
NETRC file, it provides user and password information to a foreign user 
who can then access other user's files. 

6.6.1 OS/2 RSH Client to AIX 

To execute the AIX cat command on host rs60007 the command looks like this: 
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( — 

[C:\]rsh rs66067 -1 passwd -n “cat •profile" 




\ 


PATH=/usr/bi n : /etc : /usr/sbi n : /usr/ucb : $H0ME/bi n : /usr/bi n/Xll : /sbi n: . 




export PATH 






if [ -s "JMAIL" ] # This is at Shell startup, 

then echo “JMAILMSG" # operation, the Shell 

fi # periodically, 

export DISPLAY=9. 67. 38.81:0 
stty erase 6 
set -o vi 


In normal 
checks 




[C:\] 




y 



You cannot use RSH without a command and logon to the remote system as you 
can with the AIX RSH client. The OS/2 RSH client requires the user to specify a 
command. 

6.6.2 OS/2 RSH Client to VM 

To execute a command on a VM RSHD server with RACF started, you have to 
set the USER environment variable to a valid VM user ID and pass the password 
by entering it with the -1 option at the RSH command. For example, if you want 
to ask the time at the VM system wtcesa with the user ID tcpmaint and the 
password route66, the command looks like this: 

SET USER=TCPMAINT 



[C:\]rsh wtcesa -1 route66 "q t" 

TIME IS 16:61:86 EOT WEDNESDAY 67/98/92 

C0NNECT= 69:68:95 VIRTCPU= 689:98.16 T0TCPU= 989:68.29 

' — — J 



If the VM RSHD server runs without RACF, you have to set the USER 
environment variable to a valid VM user ID and enter the RSH command without 
any options. 

SET USER=tcpmaint 



[C:\]rsh wtcesa "q t" 

TIME IS 16:94:66 EOT WEDNESDAY 87/98/92 

C0NNECT= 89:88:85 VIRTCPU= 889:86.16 T0TCPU= 688:88.29 
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Chapter 7. Domain Name Server 



This chapter describes how to set up and maintain a domain name server with 
TCP/IP V2.0 for OS/2. The files required for this function are contained in the 
Domain Name Server Kit of the product. TCP/IP V2.0 for OS/2 implements a 
domain name server as well as a domain name resolver, the latter being part of 
the Base Kit and automatically installed with it. 

A more detailed documentation of the domain name server is contained in the 
TCP/IP V2.0 for OS/2 Domain Name Server Guide. 

A more detailed description of the domain name resolver can be found in the 
TCP/IP V2.0 for OS/2 User's Guide. 



7.1 Domain Name System and Application Usage 

Apart from using IP addresses to identify a TCP/IP host, the use of host names 
has been introduced. A set of hosts and names can be grouped to form a 
domain. Domains are arranged hierarchically to form the domain name system 
(DNS), descending like a tree from a root domain. 

You can refer to hosts in your domain by host name only; however a name 
server requires a fully qualified domain name. For instance, a host name of 

host 

and a domain name of 
domain. parent. root 

will make a fully qualified domain name of 
host . domai n . parent . root 

with host name and domain names, according to the domain hierarchy, 
separated by periods. The local resolver combines the host name with the 
domain name before sending the address resolution request to the domain name 
server. 

TCP/IP applications contact a name server whenever it is necessary to translate 
a domain name into an internet address, or when information is required about a 
domain. The name server performs the translation if it has the necessary 
information. If it does not have the necessary information, the name server can 
contact other name servers, which in turn can contact other name servers. This 
process is called a recursive query. Alternatively, a name server can simply 
return the address of another name server that might hold the requested 
information. This is called a referral response to a query. Name server 
implementations must support referrals, but are not required to perform 
recursive queries. 

7.1.1 The IN-ADDR.ARPA Domain 

The DNS defines a special domain called IN-ADDR.ARPA to translate internet 
addresses to domain names. The format of an in-addr.arpa name is the reverse 
octet order of an IP address concatenated with the in-addr.arpa string. For 
example, the address 9.67.43.100, would be 100.43.67.9.in-addr.arpa. This 
scheme is sometimes referred to as reverse name resolution. 
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7.2 Domain Name Resolver and Domain Name Server 

The resolver is comprised of a few routines that build query packets and 
exchange them with the name server. TCP/IP for OS/2 applications have a 
gethostbyname() and gethostbyaddr() routines compiled into their code that 
resolves host names into internet addresses. This code accesses a name 
server, host table, or both, depending on your configuration. 

7.2.1 The HOSTS File 

If you are not using a name server but you still need to map host names to IP 
addresses, you need to create a HOSTS file in the \TCPIP\ETC subdirectory. In 
this file, each line contains an IP address and a host name that you want 
associated with it. 

9.67.38.81 martin 
9.67.38.106 miers 
9.67.38.115 cidserver 
9.67.38.83 as400 

9.67.38.65 vm 

Note: The contents of a HOSTS file are entirely local to the system that this file 
resides on. A domain name server can be thought of as a centralized 
HOSTS file. 

7.2.2 The RESOLV File 

Each system that is going to use the name server needs to know its internet 
address. Multiple name servers can be defined in the TCPIP\ETC\RESOLV file 
at the DNS clients to have backup variants. If none of the name servers in the 
list responds, then the HOSTS file is searched to find the address for the given 
name. This situation is responsible for very slow response times during the 
connection set up. You can change the configuration in the RESOLV file as 
shown in the following example: 

{domain domainname 

{nameserver IP address 

domain itsc.raleigh.ibm.com 

nameserver 9.67.38.115 

1. The domain statement defines the local domain for the system. 

2. This is the first name server that is asked to resolv the name. If you want to 
use the HOSTS file only, do not code the nameserver statement. 

3. If the first name server does not respond, the next available name server in 
the list is asked. 

The OS/2 resolver accesses the local host table only in the following cases: 

• You have not defined a name server in the RESOLV file. 

• The name server either does not respond, or the name server responds with 
an unknown host error. 

The name server communicates with other name servers to query records 
outside its zone, to answer queries about zones for which it has authority, and to 
transfer zones both to and from other name servers. 

The name server has a function similar to the HOSTS file; its prime function is to 
translate names into internet addresses. The name server database can be 
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administered centrally. It is no longer necessary to maintain many HOSTS files 
on various systems. 



The following illustrates the search flow for domain name resolution: 

remote systems 




Cache 



secondary 
Name Server 



Database 



Cache 



primary 
Name Server 



Database 



Master Files 



in memory 



in memory 



on disk 



Notes: 

1. A user program that needs to resolve host names to internet addresses (or 
the other way round) would 

a. Contact the resolver on the local host if no RESOLV file exists; the 
master file would then be the local HOSTS file. 

b. Contact the name server specified in the RESOLV file; the master file 
would then be the name server's NAMED.DOM file. 

2. If the first name server could not resolve the name, it might forward the 
request to another name server that ranks higher in the DNS hierarchy. The 
NAMED.CA file specifies which server that would be. 

3. The name server database is built in memory from the master files. 

4. The name server cache holds recent resolve requests. 

5. A secondary name server would have no master files. 



7.3 Domain Name Server Configuration 

The domain name server maps a host name to an internet address or an 
internet address to a host name. The domain name server is like a telephone 
book that contains a person's name, address, and telephone number. For each 
host, the name server can contain internet addresses, nicknames, mailing 
information, and available well-known services (for example, DNS, SMTP, FTP, or 
Telnet). 

When a client needs to communicate with another host, the client uses either the 
internet address of the remote host or sends a query to the domain name 
system (DNS) for host name resolution. 
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Before the name server can resolve a query, it must be supplied with resource 
records that either define a zone or a remote name server. For information 
about resource record format, see the Domain Name Server Guide. 

7.3.1 Types of Domain Name Servers 

If a name server defines local data and has authority for that zone, it is called a 
primary name server. If a name server zone transfers a zone from a remote 
primary name server, it is called a secondary name server. Once a secondary 
name server receives zone data, it has authority for that zone. The secondary 
name server refreshes its zone data using the value defined in the zone's 
authority record. 

A name server that does not have authority for any zone is called a caching-only 
name server. A caching-only name server must communicate with a remote 
name server in the internet that has access to zone data. The OS/2 name server 
runs as a primary, secondary, or caching-only server. 

7.3.2 Name Server Configuration Files 

The name server uses several configuration files to load its database. This 
section describes the necessary files and their format. 

Boot file (NAMED.BT) 

The TCPIP\ETC\NAMEDB\NAMED.BT file is the configuration file for the name 
server. The NAMED server reads the NAMED.BT file when it starts. The records 
in the NAMED.BT file tell the NAMED daemon what type of server it is, which 
domains it has authority over (its zones of authority), and where to get the data 
for initially setting up its name resolution database. 

Any data files referenced in the NAMED startup file must be in Standard 
Resource Record Format. These data files can have any name. Comments in 
the boot file begin with a (semicolon) and end at the end of the line. 

The NAMED boot file is organized in lines. Valid lines and their formats in the 
NAMED.BT file are: 

domain 1tsc.raleigh.ibm.com 

The domain entry indicates that the following domain entry is the name of the 
default domain for the name server. When the NAMED daemon receives a query 
with a domain or host name that does not end with a V (period), the NAMED 
daemon appends the default domain name to the queried name. 

primary test . ral ei gh . i bm.com c:\\tcpi p\\etc\\namedb\\named . dom 

The primary entry indicates that the local NAMED server is the primary name 
server for the domain specified in the second field and that the NAMED daemon 
is to get the data describing the domain from the file specified in the third field. 

Note: The full path name must be specified in the third field. See example later 
in this chapter for primary name server configuration file. 

secondary raleigh.ibm.com 9. 67. XX. 143 c:\\tcpip\\etc\\namedb\\named.sac 

The secondary entry indicates that the local NAMED server is a secondary name 
server for the domain specified in the second field and that the NAMED daemon 
is to get the data describing the domain from one or more remote primary 
name servers using the Internet address or addresses specified in the third 
field. The NAMED daemon tries each address in the order listed until it 
successfully receives the data from one of the name servers. The NAMED 
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daemon will back up the information it receives from the primary name server 
in the file specified in the fourth field. Whenever a new copy of the domain 
information is received from one of the primary servers, this file will be 
updated. The daemon will use this file as its initial cache any time the 
primary name server is down. In the secondary line, the fourth field is required. 

Note: The full path name must be specified in the fourth field. See the Domain 
Name Server Guide for secondary name server configuration file. 

cache . c:\\tcpip\\etc\\namedb\\named.ca 

The cache entry indicates that the local NAMED server is a caching name server 
for the domain specified in the domain field and that the NAMED daemon is to 
get the data describing the domain from the file specified in the third (source) 
field. 

The name server first needs to know the root name server (the name server on 
the network with the highest authority). The root name server is established in 
the NAMED.BT file by specifying the root server file name (NAMED.CA) as the 
cache for this name server. 

Note: The NAMED daemon does not provide other hosts with the information 
contained in a cache file. Cache files are usually used for listing the 
name servers for domains higher than the local domain. The full path 
name must be specified in the third field. 

Cache file (NAMED.CA) 

The name server needs to know the servers that are the authoritative name 
servers for the root domain of the network. To do this we have to prime the 
name server's cache with the addresses of these higher authorities. The 
location of this file is specified in the NAMED.BT file. This file uses the 
Standard Resource Record Format. See the Domain Name Server Guide for 
NAMED.CA file format. 

Domain Data files (NAMED.DOM and NAMED.REV) 

These files contain all the data about the machines in this zone. 

The NAMED.REV file specifies the IN-ADDR.ARPA domain. This is a special 
domain for allowing address to name mapping. As internet host addresses do 
not fall within domain boundaries, this special domain was formed to allow 
inverse mapping. The IN-ADDR.ARPA domain has four labels preceding it. 
These labels correspond to the 4 octets of an Internet address. All four 
octets must be specified even if an octets is zero. The Internet address 
9.67.XX.143 is located in the domain 143.XX.67.9.in- addr.arpa. See the example 
later in this chapter for NAMED.DOM and NEMED.REV file format. 



7.4 Installing and Starting the OS/2 Domain Name Server 

The domain name server component is contained in the Domain Name Server 
Kit for TCP/IP V2.0 for OS/2. You can install it either in addition to the base kit, 
or later on as a separate component. In that case, insert the Domain Name 
Server Kit diskette into drive A: and enter: 

A:TCPIN$T 

You can likewise install the Domain Name Server Kit from a remote drive, using, 
for instance, the remote installation method provided with TCP/IP V2.0 for OS/2, 
or IBM OS/2 LAN Server V3.0. 
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Note: The TCP/IP V2.0 for OS/2 Base Kit is a prerequisite for the Domain Name 
Server Kit. 

The components that get installed with the Domain Name Server Kit are stored 
in the following subdirectories: 

Component files Subdirectory 

Programs The executable program files for this kit (NAMED.EXE, 

NSSIG.EXE, N-XFER.EXE) are installed in the \TCPIP\BIN 
subdirectory. 

Configuration The sample configuration files for this Kit (NAMED.BT, 

NAMED. DOM, NAMED.REV, NAMED.CA) are installed in the 
\TCPIP\ETC\NAMEDB subdirectory. 

Once you have set up all necessary configuration files and placed them in the 
proper directories, just enter: 

named 

to start your domain name server. You can add this line to your 
TCPSTART.CMD file if you want the name server to start up automatically with 
TCP/IP V2.0 for OS/2. 

The following screen shows an OS/2 domain name server after startup: 



— 



IBM OS/2 Name Server (NAMED) Version 2.6 



named 4.8.3: restarted on Tue Aug 24 15:45:88 1993 
bootfile = C:\TCPIP\ETC\namedb\named.bt 
zone information (1): 
origin ='itsc. raleigh.ibm.com' 

type = Primary source = c:\tcpip\etc\namedb\named.dom 

zone information (2): 

origin ='64.38.67.9.in-addr.arpa' 

type = Primary source = c:\tcpip\etc\namedb\named.rev 
database initialized 
Ready to answer queries. 

y 



Figure 85. OS/2 Domain Name Server 



7.5 Example Scenario 

The following example shows the definitions we used for the OS/2 name server 
in our test environment. 

7.5.1 .1 NAMED.BT File 

This file will be read by the NAMED daemon at startup. 

; NAMED.BT file for name server configuration, 
i 

; type domain source file or host 

> 

domain itsc.raleigh.ibm.com 
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c : \\tcpi p\\etc\\namedb\\named . ca 



; cache 

9 

primary itsc.raleigh.ibm.com c:\\tcpip\\etc\\namedb\\named.dom 

primary 64. 38. 67.9. i n-addr. arpa c:\\tcpi p\\etc\\namedb\\named. rev 

9 

; secondary test.raleigh.ibm.com 9. 67. XX. 143 c:\\tcpip\\etc\\namedb\\named.sac 



Notes: 

1. We did not use a cache Tile in this scenario since our domain was not 
connected to any domain higher in the DNS hierarchy. Thus, our name 
server did not have to call for a root name server. In this case, we get the 
message No rootnameserver for calss 1 when the name server is contacted 
for the first time. That is not an error in this case. 

2. The second primary entry enables this server to handle reverse name 
resolution by obtaining necessary information from the indicated NAMED.REV 
file. 



7.5.1 .2 NAMED.DOM File 

The following example shows part of the file that contains our domain definitions: 



$0RIGIN itsc.raleigh.ibm.com. 



************************** ****** 

* Start of Authority Records * 
******************************** 



@ IN SOA cidserver.itsc.raleigh.ibm.com. 

nsadmin.itsc.raleigh.ibm.com. ( 

93082401 ; Serial number for this data (yymmdd##) 
86400 ; Refresh value for secondary name servers 

300 ; Retry value for secondary name servers 

864000 ; Expire value for secondary name servers 

3600 ) ; Minimum TTL value 



@ IN NS cidserver.itsc.raleigh.ibm.com. 



******************************** 

* Domain Address Information * 
******************************** 



cidserver IN 

IN 

IN 

IN 

IN 

9 

wtcesa IN 

IN 

IN 

IN 

IN 



A 9.67.38.115 

HINFO IBM PS/2-80 OS/2-2.1 

WKS 9.67.38.115 tcp ftp telnet 

WKS 9.67.38.115 udp echo sunrpc 

TXT "Location: ITSC Lab" 

A 9.67.38.65 

HINFO VM/ESA 

WKS 9.67.38.65 tcp ftp telnet 

WKS 9.67.38.65 udp echo sunrpc 

TXT "Location: ITSC Subarea 18" 
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7.5.1 .3 NAMED.REV File 

The following example shows part of the file that contains our domain definitions 

for reverse name resolution: 

• 

> 

$0RIGIN 38.67.9. in-addr.arpa. 

» 

. ******* ************************* 

;* Start of Authority Records * 

********************************* 

I 

s 

0 IN SOA cidserver.itsc.raleigh.ibm.com. 

nsadmi n . i tsc . ral ei gh . i bm. com. ( 

93082401 ; Serial number for this data (yymmdd##) 

86400 ; Refresh value for secondary name servers 

300 ; Retry value for secondary name servers 

864008 ; Expire value for secondary name servers 

3600 ) ; Minimum TTL value 

> 

0 IN NS cidserver.itsc.raleigh.ibm.com. 

> 

.******************************** 

;* Domain Address Information * 

.******************************** 

115 IN PTR cidserver 

65 IN PTR wtcesa 



Note: With a subnet mask of 255.255.255. 192, our network would actually be 
9.67.38.64 as specified on the primary entry for reverse resolution in the 
NAMED.BT file. Thus, the network for reverse resolution would be 
64.38.67.9.in-addr.arpa. However, specifying subnets in the NAMED.REV 
file will cause calls to the server to fail, though the server will start 
normally. 



7.6 Domain Name Server Maintenance 

When you set up a name server with TCP/IP V2.0 for OS/2, you will first of all 
want to check whether the server is functioning properly. There are several 
ways for querying a name server 

1. HOST 

2. NSLOOKUP 

3. NSSIG 

4. A Resolver Programming Interface (API). 

The HOST command allows you to query an address or a host name and get the 
corresponding host name or address back from the name server. 
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/ 

[C:\]host ra!yas4b 

ralyas4b.itsc.raleigh.ibm.com is 9.67.38.83 


s 


[C:\]host 9.67.38.126 

9.67.38.126 is murphy. itsc.raleigh.ibm.com 




[C:\] 




J 


The NSLOOKUP program provides a more elaborate way to query a name server. It 
can also be used to obtain information about the status of the name server. The 
advantage of NSLOOKUP is that it allows you to have an interactive session with 
a name server until you enter exit. 


The following shows an NSLOOKUP session querying the status of a name 
server and a host name: 


[C ; \tcpi p\etc]nsl ookup 

Def aul t Server: ci dserver . i tsc . ral ei gh . i bm. com 
Address: 9.67.38.115 


a 


> set all 

Default Server: cidserver.itsc.raleigh.ibm.com 

Address: 9.67.38.115 




Set options: 

nodebug defname search recurse 

nod2 novc noignoretc port=53 

querytype=A class=IN timeout=4 retry=4 

root=ns. nic.ddn.mil 
domai n=i t sc . ral ei gh . i bm. com 

srchlist=i tsc. ral eigh.ibm.com/ral eigh.ibm.com/ibm. com 


> osx25 

Server: cidserver.itsc.raleigh.ibm.com 

Address: 9.67.38.115 




Name: osx25.itsc.raleigh.ibm.com 

Address: 9.67.38.70 




> exit 




^ [C:\tcpip\etc] 


J 



Figure 86. NSLOOKUP Querying a Domain Name Server's Status 

To obtain status and dump information from a name server's database is 
provided with the command NSSIG. NSSIG also gives you the opportunity to read 
the NAMED. BT file and update the name server database without restarting the 
server. To do so, issue the following command: 

nssig -HUP 

To dump the currently active name server database from memory into a file, use 
the following command: 

nssig -INT 

The database dump file created is \TCPIP\ETC\NAMEDB\NAMED.DMP. This file 
ought to reflect the contents of the NAMED.DOM file. 



Chapter 7. Domain Name Server 125 






To dump the current status of the name server into a file, enter: 
nssig -IOT 

The status dump file created is \TCPI P\ETC\N AMEDB\N AMED.STS. This file 
looks like the following: 



/ 




A 


m 


Tue Aug 24 14:47:00 1993 




109 


time since boot (secs) 




109 


time since reset (secs) 




8 


input packets 




8 


output packets 




8 


queries 




0 


iqueries 




0 


duplicate queries 




0 


responses 




0 


duplicate responses 




5 


OK answers 




3 


FAIL answers 




0 


FORMERR answers 




0 


system queries 




1 


prime cache calls 




0 


checkjis calls 




0 


bad responses dropped 




0 


martian responses 




0 


Unknown query types 




5 


A queries 




3 


PTR queries 




V 







Figure 87. Status Dump of an OS/2 Domain Name Server 

For a detailed discussion of NSLOOKUP and NSSIG, please refer to the Domain 
Name Server Guide. 
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Chapter 8. Electronic Mail, NewsReader/2, TALK 

This chapter describes: 

• Electronic Mail 
- SMTP 

— LaMail 

• NewsReader/2 

• Talk 



8.1 Electronic Mail 

This section describes the mail services in Transmission Control 
Protocol/Internet Protocol, which are based on the Simple Mail Transfer Protocol 
(SMTP). The Multipurpose Internet Mail Extensions (MIME) extension to SMTP 
will be covered at 9.9.2, “MIME (RFC 1521)" on page 168 topic at Chapter 9, 
“UltiMedia Mail/2" on page 147 chapter. 

The basis of mail services in TCP/IP V2.0 for OS/2 is the SENDMAIL program 
(SENDMAIL.EXE), which provides client and server functions compliant with 
SMTP. LaMail is also provided with TCP/IP V2.0 for OS/2. This program gives 
you enhanced mail handling facilities as a Presentation Manager application. 

You should note that LaMail requires basic send and receive functions provided 
by SENDMAIL. 

SENDMAIL uses SMTP to route mail from one host to another host, allowing you 
to exchange mail with other hosts that support SMTP. SENDMAIL functions as a 
mail router, that listens for and receives mail from the network and sends mail to 
the network. It stores incoming mail in the TCPIP\ETC\MAIL directory. You can 
then use LaMail to look at the mail; therefore, LaMail does not have to be 
running to receive mail. 



8.1.1 SENDMAIL 



8.1 .1 .1 Configuration 

Before you try to use SENDMAIL, you must configure the software. Configuration 
information for SENDMAIL is stored in the file SENDMAIL.CF. There are several 
configurable options, but primarily, you should ensure that this file includes your: 

• Host name 

• Domain name 

A basic understanding of named servers is required to ensure that your domain 
name is correctly configured. Refer to Chapter 7, “Domain Name Server” on 
page 117 for more information about domain name servers. 

You can make configuration changes by editing SENDMAIL.CF using an editor 
like E.EXE or one that preserves tabs in a file. You will need to change these 
parameters: 

Parameter Value 

DW Host name 
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cw 

DD 



Host name 
Domain 



You should also ensure that these directories exist in your ETC subdirectory: 

Subdirectory Description 

MAIL Incoming mail is stored in this directory (This is configurable) 
MQUEUE Outgoing mail and temporary files are stored in this directory 

8.1 .1.2 Starting SENDMAIL 

Normally, SENDMAIL should be run continuously as a background process to 
allow you to send and receive mail. You can either configure SENDMAIL for 
autostart, and it will start when TCPSTART.CMD is executed, or you can execute 
the SENDMAIL.EXE from an OS/2 command prompt. 

Configuring for Autostart 

1. Start the TCP/IP configuration notebook. 

2. Click on the Autostart tab of the notebook. 

3. Click on the right arrow at the bottom right-hand corner of the page until 
page 3. Select Enable this machine to receive mail from others. 

4. Customize the default parameters. The value 30m specifies that any queued 
mail items be reprocessed every 30 minutes. Our value is 15m. 

Your panel should look like this: 



fg / IF^|G oi i f i gurati o rf 



' a^^'-Conf igure Automatic Starting Of . 



(routed) □Minimized lj||f j J 




N etwof 
iR outiil^j 
Autostart 



| SLIP; 



Servlca ^ 

HE 



X25S 



PMX; 






Figure 88. TCP/IP Configuration (Autostart) 
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5. Close the configuration menu by double clicking on the top left hand comer 
of the window. 

Click on Save. 

From now on, anytime you execute TCPSTART.CMD, the SENDMAIL service 
will automatically be started. 

Starting SENDMAIL from an OS/2 command prompt Shown below is the 
command used to start the SENDMAIL server from an OS/2 command prompt, 
and the results of this command: 

[C:\tcpip\bin]sendmail -bd -ql5m 
IBM OS/2 SENDMAIL VERSION 1.2.9 
reading C:\TCPIP\ETC\sendmail.cf 
starting sendmail process 
sendmail process started 

8.1 .1.3 Sending Mall 

1. Using an editor, create a file with the desired contents of your note. 

2. Type the following command at an OS/2 command prompt. 

sendmail -af notetornn.txt -f miers@miers.itsc.ra1eigh.ibm.com 
mart i n@marti n. i tsc . ral ei gh . i bm. com 

Press Enter. 

Parameter Value 

Contents of Note notecomm.txt 

From miers@miers.itsc.raleigh.ibm.com 

To martin@martin.itsc.raleigh.ibm.com 

The results of this command should look like this: 



— — 

[C:\tcpip\bin]sendma11 -af \notetomn.txt -f niersSm1ers.1tsc.ra1eigh.iliffl.coa mar 

t1nSmartin.itsc.ra1e1gh.ibm.com 

IBH OS/2 SENDMAIL VERSION 1.2.9 

reading C:\TCPIP\ETC\sendmail.cf 

/ 



This item of mail has been sent. 

Please note that you must always specify a user ID in the destination for the mail 
item. This is not used by OS/2 (which is a single user environment), but the mail 
will be returned to you if it is omitted (we have forgotten to include martin@ in 
the destination of this command): 





[Cs\tcpip\bin]sendmai1 -af \notetonm.txt -f miersfmiers.itsc.ra1eigh.ibm.com mar 

tin.itsc.ra1eigh.ibm.com 

IBM OS/2 SENOMAIL VERSION 1.2.9 

reading C:\TCPIP\ETC\sendmai1.cf 

08/95/93 17:09:57 mail delivered from: miersfmiers.itsc.ra1eigh.ibm.com 
/ 



Please note that the item of mail will also be returned to you if sendmail is not 
running at the destination: 
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/ — — V 

[C:\tcpip\bin]sendmail -af \notetonm.txt -f mi ers§miers.itsc.ral eigh.ibm.com mar 

tin5martin.itsc.raleigh.ibm.com 

IBM OS/2 SENDMAIL VERSION 1.2.9 

reading C:\TCPIP\ETC\sendmail.cf 

cannot send mail to martinSmartin.itsc.raleigh.ibm.com - mail will be queued 
Saving message in C:\TCPIP\ETC\mail\dead.letter 

08/05/93 17:14:42 mail delivered from: miersSmiers.itsc.raleigh.ibm.com 
\ J 



This mail item is stored in the \tcpip\etc directory, and SENDMAIL will attempt to 
send the item again in 15 minutes. (This is the value that we specified at startup 
-ql5m). 



8.1.2 LaMail 

LaMail allows you to: 

• View incoming mail from the ETC\MAIL directory 

• Save mail in mail folders in the LaMail directory 

• Define and use nicknames and groups (distribution lists) in 
NICKNAMES.NAM file in the LaMail directory 

• Create, answer, forward, print and send notes 

LaMail has an integrated editor for editing notes that can also be used for 
normal file editing. The editor supports multiple files in multiple windows and 
the Presentation Manager clipboard. 

SENDMAIL must be running to have mail sent from or received at your 
workstation. LaMail can run without SENDMAIL however, when you send a note 
from LaMail, it is queued, but not actually sent, until SENDMAIL has been 
started. 

To start LaMail, you should open the LaMail object in the TCP/IP folder when the 
application starts, your panel will look like this: 
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Figure 89. LaMail Folders 



8.1.3 The Mail Environment in OS/2 
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Figure 80. The Mail Environment Default Directory Structure 





TCPIP\ETC 

SENBMAIL.CF — 

TCPIP\ETC\MAIL 

Received Mail « 
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(INBOX. NDX) 



TCPIP\ETC\MQUEUE 



Temporary storag 



SENDMAIL 




The default directory structure for mail services is shown in Figure 90. Each 
mail folder in the LaMail directory is implemented as an index file (.NDX) and a 
subdirectory with the same name. The mail is then stored in the subdirectory. 
LaMail will create a mail folder with the name of OUT for temporary storage of 
outgoing mail. 



LaMail will run progressively slower as the ETC\MAIL directory fills up. Keep 
less than 200 notes by deleting notes or transferring them to mail folders. 



8.2 NewsReader/2 

NewsReader/2 is an OS/2 application that is included in the TCP/IP V2.0 for OS/2 
package. It can be used to access USENET news servers on the Internet. Most 
news servers contain a broad range of news groups. Their content varies from 
technical computing subjects to recreational and cultural articles. With 
NewsReader/2 you can: 

• Subscribe to news groups 

• Read new articles 

• Post your own articles 

8.2.1 Configuring NewsReader/2 

There are many news servers available on the Internet. We recommend that you 
consult with your network administrator for the name or IP address of your news 
server. These news servers are commonly referred to by a name. This normally 
requires that you have access to a named server. Please see the previous 
section for information to connect to a named server. 
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We recommend that you try to PING the address of your news server before 
proceeding. In our examples, we are already connected to a named server, so 
we issued this PING to ensure network access : 

[C:\tcpip\etc]ping sernews.ra1eigh.ibm.com 10 1 
PING sernews.raleigh.ibm.com: 10 data bytes 
18 bytes from 9.67.10.229: icmp_seq=0. time=657. ms 

sernews.ra1eigh.ibm.com PING Statistics 

1 packets transmitted, 1 packets received, 0% packet loss 
round-trip (ms) min/avg/max ° 657/657/657 

We received a response from the address, and we can now confidently configure 
our NewsReader/2 application to use this address as our news server. 

You can configure the address of the news server in the configuration notebook 
provided with TCP/IP V2.0 for OS/2. Listed below are our recommended steps: 

1. Open the TCP/IP folder on your desktop: 






TCP/IP - Icon View 





ode 

B 





TCP/IP DOS Box Access FTP LaMail NewsReader/2 PM Ping Reed Me SUR Serial Line IP 





SUPTERM: Modem Setup SNMPTRAP TCP/IP Command Reference ] 

x 



TCP/IP Configuration 



TFTP TN5250 



TCP/IP User's Guide TCP/IP Installation and Administration X Windows Server X Windows Server Guide 

TCP/IP 






TCP/IP Extended Networking Guide StartNFS TCP/IP Programming Guide TCP/IPStertup 



Figure 91. TCP/IP Folder 



2. Open the configuration notebook, and then: 

a. Click on Services 

b. Click on the right arrow at the bottom right-hand corner of the page until 
page 3 (You should then see the Services Configuration page). 

c. Type in the name of your news server. Your panel should look like this: 
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Figure 92. Configuration Notebook 



d. Close the notebook, save any changes, and agree to changes to your 
CONFIG.SYS. These steps will modify your CONFIG.SYS to include an 
environment variable for the news server. This change will take effect 
when you reboot the machine. 

You should now be able to go ahead and start NewsReader/2 without 
rebooting. 

8.2.2 Starting NewsReader/2 

There are two ways of starting NewsReader/2: 

1. Entering the nr2 command from an OS/2 command prompt 

2. Clicking on the NewsReader/2 object in your TCP/IP folder on your OS/2 
Workplace Shell desktop. 

8.2.2.1 Starting from a Command Prompt 

We recommend that you refer to your TCP/IP command reference for detailed 
information about starting NewsReader/2 from a command prompt. We used this 
command from an OS/2 command prompt to access our news server : 

nr2 sernews.ra1eigh.ibm.com 

8.2.2.2 Starting from the Workplace Shell 

Open the NewsReader/2 object in the TCP/IP folder. 
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SUFTERM: Modem Setup SNMPTRAP TCP/IP Command Reference TCP/IP Configuration TFTP TN5250 




TCP/IP User's Guide TCP/IP Installation and Administration X Windows Server X Windows Server Guide 




TCP/IP Extended Networking Guide Start NFS TCP/IP Programming Guide TCP/IP Startup 



Figure 93. TCP/IP Folder 



8.2.3 Connecting to a News Server 

1. Once you have started the application, the NewsReader/2 - Product 
Information will be displayed on a panel. Click on OK. 

2. NewsReader/2 will now attempt to connect to your news server, and you will 
notice this message in the top right-hand corner of the NewsReader/2 
window: 



Connecting to Server... 

This connection may take several minutes, so don't panic if there is a slight 
delay at this stage. 

3. On the first occasion that you log on, you will not have these files in your 
\tcpip\etc directory: 

File Contents 



NEWS.6RP 



NEWS ALL 



NEWS.SAV 



NEWS .TIM 



This file keeps track of your subscriptions and articles 
you have viewed. Each line in the file contains a news 
group name followed by a list of seen article number 
ranges. 

This binary file contains all USENET groups which are 
known to your news server, and whether or not each 
can be posted to. This file is always required for 
adding newsgroups, and is required by default for 
making posts. 

This file is a backup of your NEWS.GRP file from the 
last session. If for some reason your NEWS.GRP file 
becomes lost or garbled, you can retrieve the lost 
information from this file. NewsReader/2 will 
automatically use the NEWS.SAV file if it is unable to 
find and/or use the NEWS.GRP file. 

This file contains the time stamp of the last time you 
started NewsReader/2. If you are using the Inform of 
new groups option in the Options- > Application 
Options... dialog, then the time stamp is used when 
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the server is queried for new groups. The format of 
the time stamp, in GMT, is: 

YYMMDD HHMMSS 

NR2.INI This file is used to store all of the application's 

information from session to session. 

NR2BATCH.ERR This file is used to log any errors encountered while 

running the application in the batch process NEWS.ALL 
building mode (the /U startup option). 

NR2.CTL This is a LAN control file which can be used to specify 

the name or IP address of the news server 
NewsReader/2 should use. The file must be placed 
somewhere on the LAN so that it can be found in the 
DPATH of each workstation. The file should consist of 
a single line: 

NEWSSERVER=<server> 



Hence you will be asked whether to include all groups: 




Figure 94. TCP/IP Installation Tool Pop-Up 

Click on Yes. 

Your NewsReader/2 panel will then display a status indicating that it is 
building NEWS.ALL, and eventually your NewsReader/2 service will start. 

8.2.4 Using NewsReader/2 

Your NewsReader/2 application consists of several windows. These windows 
contain: 

All Groups A list of all the news groups available on this server. 

Subscriptions A list of the news groups to which you subscribed on this 

server. 

Headers A list of the headers of articles on the currently selected 

news group. 

On the first occasion that you use a news server you will need to browse the list 
of news groups in the All Groups window. You should select the groups of 
interest to you by double clicking on them. Once you have selected all of your 
preferred groups, then click on Actions and Add Groups from the action bar of 
the All Groups window. Your panel should look like this: 
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Figure 95. AH Groups 



Each of the news services will be added to your Subscriptions and your panel 
should look like this: 




1 5258 LPRPORTD fraenkel@ralvrn5.vnetibm.com [9] 

1 5259 LAMA1L 1 20571 02@ehone.vnetibm.com [1 6] 

1 5260 Re: configuring TCP/IP for use with parallel bridges igovett@bMabvm.vnetibm.con 

15261 LAMA1L biragnet@watson.vnet.ibm.com [11] 

LPRPORTD was@bcrvm7.vnetibm.com [16] 

TCPPMX Package install pomar@pkedvm9.vnet.ibm.com p 1] 

FTP API (TCP/IP 2.0) rehandel@ralvm12.vnetrbm.com [11] 

Installed new TCP/IP but having problems allegra@sppvm! vnet.ibm.com p 33] 
unique pdc@sjevm5.vnetibm.com [5] 

MTU size mkuehn@kgnvmc vnetibm.com [6] 

Sending mail to an internet using LAMAJL in TCP/IP telek@betasvm2.vnet.ibm.c 



15262 

15263 

15264 

15265 

15266 

15267 

15268 







Figure 96. Subsriptions 



Double click on one of the headers and the article will appear: 
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Actions : %Opt ions' ^Configure Window Htelp \ 

#ite ^Edit ^Actions -‘Help '• ' V: %:*■ ^ '>'■'■ ' 



From: perkinsi@endvmtkLvnot.ibm.com 

Distribution: ibm 

Newsgroups: lbm.ibmpc.os2tcpip 

Message - ID: <93121 5125554.os2tcpip.ibmpc.perkinsj@endvmtkLvnetibm.com> 

Subject: QSSSS31S 

Date: 15 Dec 93 12:55:54 GMT 

References: <931214202855.os2tcpip.ibmpc.fraenket@ralvm5.vnet.ibm.com> 



Michael, 

On the Output page of the settings notebook for each printer object, 
there should be devices with the names \PIPE\LPDx where x ranges from 
0-7 by default (you can set the max up to 64 in the TCPIPCFG pages), 
i think you need to be running LPRPORTD to have the devices come up. 

Open the \PIPE\LPDx that you want to use and configure the host 
and printer queue and you*re in business. 



Jeff Perkins, IBM Microelectronics 
(tie) 855-8357 



Endicott 



Figure 97. Subscriptions 

You can read the article and then using the various action bar alternatives 
perform any of the following: 

• Copy to the clipboard 

• SENDMAIL 

• Print 

• Save to a file 

• Save to an LaMail Folder 

Once you have finished, you should click on Windows on the action bar of the 
NewsReader/2 program. This will give you a choice of any of the NewsReader/2 
windows, as shown below: 
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2^of 63 

Actions ^Options ^Configure jilWMow ^Help ' - ^ 

-File ^IEd it ^Actions ^jHelp *® i #SU8SCR I PT IONS . ^V*yZZiw': 'J ' : '‘‘-'t'’/ 

Raders ^bmjhn)pc.6s2tcpi^ 
-^ARTICLE -^LPRPORTD 



F rom: fraenkel@ r alvmb .vnet. ii 
Distribution: ibm 
Newsgroups: jbm.ibmpc.os2tcpip 

Message - ID: <9312 15122732.os2tcpip.ibmpc.fraenkel@ralvm5.vnet.ibm.com> 

Subject: QSSSS9DDE 

Date: 15 Dec 93 12:27:32 GMT 

References: <9312151 25554.os2tcplp. ibmpc.perkinsj0endvmtkt.vnet ibm.com > 



Yup, 1 tried that. It seems that there are no entries in my 
0S2SYS.INi for the LPRPORTD ports. I have a feeling that this has 
to do with the fact that I am attempting to run 2.1 SP since I had no 
problems when I was using 2.1 GA. 

Michael Fraenkel 

Network Access Workstation Technology 
T/L 441-2264 



Figure 98 . NewsReader/2 Window List 

You have now read all the basic news services provided by NewsReader/2. 

8 .2.4.1 Posting 

You can also contribute to some news groups by posting to the newsgroup, we 
recommend that you customize your headers for postings by clicking on 
Configure and Posting, which will bring up the panel shown in Figure 99 on 
page 140: 
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Figure 99. Configure Posting 

We recommend that you Check Newsgroups. NewsReader/2 will then check to 
see if you can post to a news group before you type information for posting. 

In order to post to a news group, you should click on Actions and Post from the 
Subscriptions window. You will have to type in the basic header information for 
this post: 
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Figure 100. Post... 




Click on OK. NewsReader/2 will start an editor (you can configure this from your 
main NewsReader/2 action bar) with some header information already prepared. 
You should then type the contents of your post and save. As soon as you save 
you will see this pop-up: 




Figure 101. Do you wish to post? 

Click on Yes, and NewsReader/2 will send the post to the news group. (Please 
note that you can select to defer, this will store the post and you can send it 
later by selecting Send Deferred Posts from the main action bar item for 
NewsReader/2). 

8.2.4.2 Other Features 

There are many other finer features of the NewsReader/2 service such as: 



Kill Subject 

Kill Author 

Sort 

Search 



Remove all subsequent posts with this header from your 
headers list. 

Remove all subsequent posts submitted by an author from 
your header list. 

Sort the header list by author, subject or number 
Search a news group for a particular string 
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Refresh Refresh the subscriptions now. 

Refreshing Set the frequency to refresh the subscriptions. 

Signature Signature to be attached to the end of a post. 

Export Export news group files compatible with UNIX 

Import Import news group files compatible with UNIX 

8.2.5 Changing New Servers 

Each news server has its own idea of what the article numbers are. So, if you 
switch from one server to another, NewsReader/2 will get confused as to what 
articles have been seen and what have not. 

You have to either erase the NEWS.GRP file in the local ETC directory and start 
again, or edit it and remove the article number information, leaving only the 
news group names. 

8.2.6 Directory Structure 

The first time you start NewsReader/2 on your system, it will establish its 
directory structure in your local ETC directory (this is where most of the related 
files are kept). The following is a list of the directories which are created and 
their contents: 

Directory Contents 

ETC\RNSPOOL All temporary (.TMP) and deferred posting (.SAV) files are 
kept in this directory. Files for posting, mailing, and 
replying are POSTX.TMP, MAI Ly. TMP, and REPLYz.TMP, 
respectively. Numbers x, y, and z start at 1 for each 
session and increment as you perform each task. File 
ARTICLE.TXT is also created whenever you manipulate an 
article. All *.TMP files in this directory, as well as 
ARTICLE.TXT, are deleted at the start of each session. 

ETC\KILL All killfiles are kept in this directory. The killfile for all 

groups is easily recognizable as ALLGROUP.KIL; however, 
the killfiles for each individual newsgroup are named using 
a numeric encryption. 

The directory holds the signature files available for use by 
NewsReader/2. Only files ending with .SIG will be 
recognized for use by the Configure- > Signature... dialog. 

This is where the NR2POST.LOG and NR2MAIL.LOG files 
are kept (if these log file options are being used). This 
directory can be used to hold any other log files which you 
wish to create using the File- > Save As... dialog in the 
ARTICLE window. 



ETC\SIG 

ETC\LOG 
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8.3 Talk 

This section describes the services provided by TALK in TCP/IP V2.0 for OS/2, 

which are based on the TCP/IP protocol TALK. 

TALK is used to send and receive interactive electronic messages to another 

host. 

The services consist of: 

Program Description 

TALKD.EXE The TALK server. This program needs to be running before any 
other host can initiate an interactive session with you. However, 
it will start automatically when you try to initiate an interactive 
session with another host. 

TALK.EXE The TALK client. This program can be used by you to initiate an 
interactive session with another host. It contacts the TALK 
server on the other host which notifies the user that they should 
start a TALK client. Once this has been done an interactive talk 
session will be established and you will be able to type 
messages to each other. 

Configuring for Autostart 

1. Start the TCP/IP configuration notebook. 

2. Click on the Autostart tab of the notebook. 

3. Click on the right arrow at the bottom right-hand corner of the page. Select 

Enable others to "talk" to you by using TALK. 

Your panel should look like this: 
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Figure 102. TCP/IP Configuration (Autostart) 



4. Close the configuration menu, by double clicking on the top left-hand corner 
of the window. 

Click on Save. 

From now on, any time you execute TCPSTART.CMD, the TALK daemon will 
automatically be started. 

Starting TALK from an OS/2 command prompt: To start TALK daemon from an 
OS/2 command prompt, type the following: 

start talkd 

Press Enter. 

8.3.1 Using TALK 

Here is an example of the steps to establish a conversation between two hosts, 
martin and miers: 

1. Ensure that you have TALKD running on both systems that will partake in a 
conversion. 

2. At the host miers, type: 

talk os2user@marti n 

3. At the host martin, the TALKD session will beep and this message will 
appear: 

Message from Talk_Daemon@ at 11:25 ... 

talk: connection requested by os2user@miers.itsc.raleigh.ibm.com. 
talk: respond with: talk os2user@miers.itsc.raleigh.ibm.com 
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Then, you should type this command at a new OS/2 command prompt: 
talk os2user9miers 

4. Both machines will now have an OS/2 session running talk. You can type in 
text. When you press Enter, the text will be sent to the other host who is 
partaking in the conversation. Your panel will look like this: 



/ 


\ 


Hello Kartln, Very well. Thank you 




No connection yet 
Connection established 
Hello Hlers, How are you 




V 
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Chapter 9. UltiMedia Mail/2 



UltiMail* is a multimedia electronic mail system. With UltiMail you can receive, 
read, create, and send electronic mail that contains a variety of media types 
including text, enriched text, images, audio, spreadsheets, and word processor 
documents. 



9.1 The Client and the Server 

UltiMail functions are divided between a mail client and a mail server. When you 
install UltiMail, you can install the client and the server on the same workstation, 
or you can install a server on one workstation and install clients on several other 
workstations. 

The server connects with the network, sends and receive mail, and can store 
mail for the clients it supports. You might install one mail server in a separate 
workstation to support several clients. 

The client connects to the server and uses its mail storage services, while 
providing the interface to the user. A client can connect to more than one server 
if there is a need to store mail in more than one place. 



9.2 What You Can Do with UltiMail 

UltiMail provides an electronic mail connection to the world through networks 
using the RFC 822 mail standard. With UltiMail you can send mail text to anyone 
on such networks, whether or not they are also using UltiMail. 

UltiMail also lets you author multimedia messages including enriched text, 
images, motion video, audio, and binary attachments. Your multimedia message 
is sent using the MIME (RFC 1521) standard, an extension to RFC 822. Any mail 
system that uses the MIME standard will recognize your multimedia attachments. 
Any system that supports RFC 822 without the multimedia extensions will 
recognize the text parts. Thus, with one electronic mail system, you can 
communicate with both multimedia mail users and non-multimedia mail users. 

UltiMail lets you logon to more than one mail server simultaneously. You can 
keep some of your mail on your workstation, while putting some of it in a 
common place on the network for access by colleagues. When you are logged 
onto more than one mail server, all of your mail on all of the servers appears on 
your UltiMail desktop seamlessly, so you can transfer mail from one server to 
another simply by moving it into another folder. 



9.3 The Advantages of UltiMail 

Some of the advantages of using UltiMail to handle your electronic mail are: 

• Interoperability 

• Support for multimedia mail 

• Compatibility with OS/2 Workplace Shell 

• Use of OS/2 multimedia extensions 
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9.3.1 Interoperability 

Because UltiMail implements standard protocols, you can integrate it into a 
network with other mail handlers. UltiMail uses TCP/IP's Simple Mail Transfer 
Protocol, along with the mail formats specified by RFC 822 and MIME (RFC 1521), 
to send mail through your network. You can communicate with many types of 
systems, based not only on OS/2, but also other workstations and mainframe 
platforms available from IBM and other companies. UltiMail uses standard 
protocols, rather than proprietary ones. This means that you can use it in your 
existing network. It also means that if you expand your network in the future, you 
can continue to use UltiMail on your OS/2 systems. 

9.3.2 Support for Multimedia Electronic Mail 

Electronic mail has always lagged behind "paper" mail because, until recently, 
electronic mail has been limited to plain text, while paper mail can include 
ornate text, pictures and full color. You can even send audio and video tapes 
through the mail, although the recipient would require a tape player on which to 
play them. 

UltiMail takes electronic mail beyond the boundaries of paper mail. With 
UltiMail, you can send and receive mail electronically, using all these media 
types. And the recipient can see and hear them all, right on the same 
workstation. 

9.3.3 Compatibility with the OS/2 Workplace Shell 

UltiMail is designed to fit smoothly into 0S/2's Workplace Shell, providing a 
familiar environment in which to manipulate your mail. UltiMail can be viewed 
as a master folder containing all of your electronic mail folders. Each of these 
mail folders can contain other folders and letters. Within the mail folders, letters 
are represented as envelopes and can contain enclosures (called letter parts). 

You can handle all UltiMail objects (folders, letters, and letter parts), just as you 
handle other objects on your OS/2 desktop, with the mouse and the keyboard. 

UltiMail conforms to the Common User Access* (CUA*) definition, making it 
consistent with other programs that you use. 

9.3.4 Use of OS/2 Multimedia Extensions 

UltiMail uses OS/2's multimedia extensions, available with OS/2 Version 2.1, to 
communicate with special video capture and audio hardware. This means that as 
OS/2 supports new hardware adapter cards, UltiMail will also support them. You 
will not have to wait for updates to UltiMail. 



9.4 Prerequisite Software and Hardware 

The programs and hardware, including memory and disk space, needed by the 
UltiMail Kit, are described in this topic. 
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9.4.1 Software 



To install and use UltiMail, you must have the following programs installed: 

• IBM OS/2 Version 2.1, or later 

• For sending and receiving mail, TCP/IP V2.0 for OS/2: base kit, or an 
equivalent protocol stack 

• For audio and motion video, the IBM Multimedia Presentation Manager/2 
(MMPM/2) that comes with OS/2 Version 2.1 



9.4.2 Hardware 

UltiMail requires the following hardware configuration: 

• Any computer supported by IBM OS/2 Version 2.1. A 486 processor with at 
least SMB of memory is recommended. 

• Although all functions can be performed with the keyboard, a pointing device 
(for example, a mouse or light pen) is also recommended. 

• You may use any audio adapter supported by IBM Multimedia Presentation 
Manager/2 for audio capture and playback. If you do not require audio 
support, you do not need an audio adapter. 

• For video capture, you may use any video adapter supported by IBM 
Multimedia Presentation Manager/2. If you do not want to capture (record) 
video, you do not need a video adapter. 

9.4.3 Disk Space Requirements 

The recommended disk space for this kit is approximately 9MB. 



Table 8. UltiMail Disk Space Requirements 


Component 


Disk Space (MB) 


UltiMail Base Kit 


2.5 


UltiMail Client Kit 


2.8 


UltiMail Server Kit 


1.9 


UltiMail Online Help and User's Guide 


0.8 


UltiMail Online Tutorial 


1.0 



You should add to the requirement the space needed for the electronic mail you 
expect to send and receive. 

Note: Audio and video files can be quite large. If you expect to send or receive 
such files, you must plan accordingly. Audio in MIME quality, for example, 
uses about 10KB per second. 

9.4.4 Memory Requirements 

The recommended memory for this kit is 8MB. 



Table 9. UltiMail Memory Requirements 


Component 


Recommended Memory (MB) 


UltiMedia Mail/2 


8 
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9.5 Installing UltiMail 

This topic describes how to install the UltiMail Kit at your workplace. You can 
install UltiMail either from the UltiMail diskettes or from a code server in your 
network. 

9.5.1 Installing UltiMail from Diskettes 

To install the TCP/IP for OS/2 UltiMail kit from its distribution diskettes, use the 
TCPINST installation program as follows: 

1. Insert the "UltiMedia Mail/2 diskette 1 of 4" into your diskette drive. 

2. At the OS/2 command prompt, type: 

ArTCPINST 

and press Enter. 

At this moment you should see the UltiMedia Mail/2 component selection 
screen. 




Figure 103. UltiMedia Mail/2 Installation • Component Selection Screen 



3. Select the UltiMail components to be installed from the list 

Note: If you select the server component, the client component, or both, the 
base component is also required. It is common to both the client and 
server components. 

4. If you want to install UltiMail into a directory other than the default, specify a 
target drive and a directory. 

5. If you do not want the UltiMail installation program to modify your 
CONFIG.SYS file, deselect Update CONFIG.SYS. 

6. Click on the Install button or select the Install button and press enter. 
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The installation processes will begin and you will be able to see its 
progress. 




1 C:\TCPIP\UMAIL\ itkgif.dll 
C:\TCPIP\UMAIL\ itkmain.dll 
C:\TCPiP\UMAIL\ itkbmp.dU 
C:\TCPIP\UMAIL\objeprn. dU 
C:\TCPIP\UMAIL\enricheddll 
C:\TCPIP\UMAIL\tDcatamid 
. C:\TCPIP\UMAIL\csesremtdll 
! C:\TCPIP\UMAIL\speech. dll 

C:\TCPIP\UMAIL\mailstor\umdemo\info\1\00010005.w 
i C:\TCPIP\UMAIL\mailstor\umdemo\lnfo\1\00D1000d.wav 
C:\TCPIP\UMAIL\mmserver.dll 




Figure 104 . Ulti Media MaiU2 installation Progress Screen 



You will be prompted to change the installation diskettes. 




Figure 105. UltiMedia Mail/2 Prompt to Change the Installation Diskettes 

7. If you choose to install the UltiMail client kit, you will be asked for the client 
information. 
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Figure 106. UltiMedia Mail/2 Client Installation Prompt 

8. Fill in the User part with your full name, user ID and node, which means your 
fully qualified host name. 

9. Fill in the Sessions TCP/IP part with the name of the server where the 
UltiMail server is running. 

Note: It is possible to fill the Server Name with the server's IP address but it 
is not recommended since IP addresses, normally change more often 
than host names. 

10. Click on the OK button 

If you chose to install the UltiMail server kit, you will be asked for the server 
information. 




Figure 107. UltiMedia Mail 12 Server Installation Prompt 

You don't need to change any of the fields of the UltiMail Server Installation 
at this time. The only field that you should change, is the port number field, if 
this number is already in use by another application. 

When you have successfully installed UltiMail, a message indicating that the 
installation is complete appears on the panel. 
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Installation Complete 



^iHfllnslaUalldn completed succeteftdl^^^ 
WBk tptaasa shutdownjjour system s ' 




Figure 108. UltiMedia Mail/2 Installation Complete Panel 



This ends the installation process. If you choose, on the components 
selection panel, to update the CONFIG.SYS file than you need to SHUTDOWN 
your OS/2 system and start it again to reflect the changes. 

Note: If the TCP/IP installation program updates your CONFIG.SYS, your 
current CONFIG.SYS file is saved as CONFIG.BAK. 

11. Go to an OS/2 command prompt and create the following directory: 

cd tcpip 
md tmp 

12. Open the newly created UltiMedia Mail/2 folder on the desktop and select 
the Read Me icon to review the file. 




Figure 109. UltiMedia Mail/2 Folder 

9.5.2 Changing the CONFIG.SYS File 

If you choose not to have TCP/IP or UltiMail modify your CONFIG.SYS file, you 
must do it manually: 

1. Add the UltiMail directory at the end of your LIBPATH, SET PATH, and SET 
HELP statements in the CONFIG.SYS file. 

For example, if you have installed UltiMail in 
D:\TCPIP\UMAIL 

, find the LIBPATH statement and add 

D:\TCPIP\UMAIL 

to the end of that statement. This allows the Workplace Shell classes to 
locate the UltiMail dynamic link libraries. 

You must also add the UltiMail directory at the end of the SET HELP and SET 
PATH statements. 

2. Shut down your workstation and restart it to activate the changes. 
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9.5.3 Installing UltiMail from a Code Server 

If you have already installed the TCP/IP V2.0 for OS/2 base kit and have a code 
server in your network, you can install the UltiMail kit remotely, from a code 
server on another workstation. 

This kit complies with IBM's Configuration, Installation, and Distribution (CID) 
architecture, which provides for unattended, remote installation of programs and 
applications from code servers to client workstations. 

For more information about how to install this kit from a code server to a client 
workstation, see IBM TCP/IP Version 2.0 for OS/2: Installation and Administration. 



9.6 UltiMail Customization 

This topic describes how to use the UltiMail Settings notebooks to configure the 
client and the server respectively. 

9.6.1 The Client's Settings Notebook 

To open the client Settings notebook, do the following: 

1. Start the UltiMail client by double clicking on the UltiMail icon at the 
UltiMedia Mail/2 folder 




Figure 110. UltiMail icon at the UltiMedia Maill2 Folder 

2. Go to the Actions option at the top of the created UltiMail frame and select 

Logon... 




Figure 111. UltiMail Actions Options 

Fill in your password and click on the LOGON button 
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Figure 1 12. UltiMail Logon Information 

3. Now you have to go to the View option and select Settings... 




Figure 113. UltiMail View Options 

You will see the UltiMedia Mail/2 Settings frame: 




Figure 1 14. UltiMail Client Settings Book • Profile Page 

4. At the Profile page fill in your user ID and password 

5. Select the Sessions page 
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Figure 115. UltiMail Settings Book - Sessions Page 

6. Select TCP/IP UMail option. 

7. Fill in your user ID and password fields. 

8. If you want to be automatically logged on to the server when you start your 
client, check the Logon: automatically box. 

9. Click on Letter 1. 




Figure 116. UltiMail Settings Book - Letter 1 Page 



10. Select Address: Medium option as in the figure above. 
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11. Fill in the signature field with your personal signature. It will be placed at the 
end of each note that you send. 

12. Select Text/plain at the Create option. 

13. Close the UltiMedia Mail/2 Settings Book. 

14. If your server is not configured yet, you should go to 9.6.2, “The Server's 
Settings Notebook," configure the server and return to this point. If it is 
already configured, skip this step. 

15. Now that your server is configured, up, and running, you can return to the 
Actions option and select Logon... 




Figure 117. UltiMail Client Logon Screen 

16. Select TCP/IP UMail (CSESREMT) option and click on the Logon button. 

You should now see the two icons representing your InBox Notes and your 
All folder. 




ift=n ifo“H 

InBox All 



* 



Figure 1 18. UltiMail User Desktop 

This finishes your simple configuration. For more details on the configuration 
see 9.7, “Sending Mail Using UltiMail” on page 163. 



9.6.2 The Server's Settings Notebook 

To open the Server Settings Notebook, do the following: 

1. Start the UltiMail server by double clicking on the UltiMail Server icon in the 
UltiMedia Mail/2 folder. 



fjtj Ultimedia Maii/2 - Icon View 




UltiMail 





User's Guide 




T utoria) Read Me 




Figure 119. UftiMedia Mail/2 Icon View 
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A new frame will be created. 






^Ser ver View Help 



Activate,. 




UltiMafl Server started 
New Mail arrival detection thread started 



Figure 120. UitiMail Server Frame 

2. Select Server and then Activate... option. 




Figure 121. UitiMail Activate Sessions 

3. Select TCP/IP Port 555, max: 20 option and then click on the Activate button 

At this moment you will see the session between the UitiMail server and 
TCP/IP port 555 started at the server's frame. 



grj UitiMail Server (1.00) ^Activated 



%g|4 









93 02:24:05 PM: UitiMail Server started 
93 02:24:06 PM: New Mail arrival detection thread started 
93 02:24:54 PM: Session ‘TCP/IP Port: 555, max: 20(1319210)* started 



p3 02:24:5 4 - PM: Sessiohlgl^/I^Port$555^|max:f20{;1 3/1921 0 If^wai ting tar a user to connect 



mwm 






Figure 122. UitiMail Server Frame Session Messages 

4. Go to the View option at the server's frame and select Settings... 
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Figure 123. UltiMail Server Settings Book 



You don't need to change any of the default settings. The only thing to do 
here is to check the Logon: automatically box, if you want the session 
between UltiMail and TCP/IP port 555 started automatically. 

5. Select Users page 




Undo I | Help 



page 3d 3 j+j 



Sessions 



Figure 124. UltiMail Server Settings - Users Page 

Now you need to add the users that have authority to log on to this server 
and their respective passwords and root directories. 

6. After filling in the necessary fields, click on the Add button. 
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7. Select Sendmail page 

Now we need to fill in the information necessary for the SENDMAIL process. 




Figure 125. UltiMail Server Settings • Sendmail Page 

At the Mlocal option: 

8. Fill the P field with the path to the umailer.exe mail handler file 

For example if your installation path was C:\TCPIP than you should fill this 
field as follows: 

P=C:\TCPIP\UMai l\Umai ler.exe 

Now we need to fill the A field. Do as follows: 
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Figure 126. UltiMail Server Settings - Sendmail Page 

A=-dest "InBox directory" -to $u 
See the figure above to see an A field example. 

9. Click on the Save button 

At this time the UltiMail Settings Book will back up your old SENDMAIL.CF 
file and create a new one with the information obtained from our 
configuration. 



<Sendmail Configuration 




Figure 127. Sendmail Configuration 

Note: You may choose to not let the UltiMail Server Settings Book change 
your SENDMAIL.CF file. If this is your choice you must do it manually. 
For more information on Sendmail configuration see 9.6.3, 
“Customizing Sendmail for UltiMedia Mail/2.” 

10. Close the UltiMail Server Settings Book. 

Now your server is ready to receive logon requests from the foreign clients. 



9.6.3 Customizing Sendmail for UltiMedia Mail/2 

If you did not configure Sendmail through the Server Settings Notebook, you 
must edit the SENDMAIL.CF file, which is usually installed in your \TCPIP\ETC 
directory. This is the subdirectory specified in the ETC environment variable. 
Look for the SET ETC= entry in your CONFIG.SYS file or type: 

echo %ETC% 
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at any OS/2 command prompt. 



Warning! 

When you modify SENDMAIL.CF file, use a text editor that preserves tab 
characters, such as the OS/2 System Editor (E.EXE). Other text editors might 
expand the tab characters into spaces and make the file unusable. It's a 
good idea to make a backup copy of SENDMAIL.CF file before you change it. 



The values set in SENDMAIL.CF determine how the Sendmail program runs. Do 
not change any entries other than those recommended unless you are certain of 
the effect of your changes. If SENDMAIL.CF file is incorrect, you might not be 
able to send or receive mail. 

The following table shows the particularly important SENDMAIL.CF entries for 
UltiMail. 



Tabie 10. Important Sendmail Entries to UltiMail 


Entry 


Explanation 


00 


Specifies the path to the mail queue. This is where Sendmail holds mail that 
UltiMail has asked it to send. It is recommended that you create a subdirectory 
such as \TCPIP\MQUEUE specifically for this purpose. 


Cw 


Specifies your host (workstation) name. You can use the TCP/IP hostname 
command to display your host name. 


Dw 


Specifies your host (workstation) name. This should be the same as the Cw entry. 


DV 


Specifies the host name of your mail gateway. Mail that cannot be delivered 
directly is sent to this address to be relayed. 


DD 


Specifies your local domain name. 


Mlocal 


Define aspects of your local mail handler. See the value of Mlocal entry at 
Figure 125 on page 160 and Figure 126 on page 161. 



9.6.4 Starting Sendmail 

You can choose to start Sendmail automatically each time your workstation 
session is started or manually by issuing the sendmail command. 

To start Sendmail automatically you must update your TCP/IP Configuration 

Notebook. 

1. Select (double click on) the TCP/IP folder from the desktop icons. The TCP/IP 
icon view folder is displayed. 

2. Select the TCP/IP Configuration Icon. The TCP/IP Configuration Window is 
displayed. 

3. Select the Autostart page. 

4. Checkmark the Enable this machine to receive mail from others (Sendmail) 
option on page 3 and specify the following parms: 

-bd -q30m 

5. Close the TCP/IP Configuration Notebook. The Closing TCP/IP Configuration 
pop-up window is displayed. 

6. Select the Save option. 
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From now on Sendmail will automatically start when your workstation is 
started. 

To start Sendmail manually just issue the following command: 
sendmail -bd -q30m 
from an OS/2 command prompt. 



9.7 Sending Mail Using UltiMail 

This topic describes how to send mail using UltiMail It is a step-by-step 
description of what you have to do to send your mail using this powerful 
multimedia mail handler. 

9.7.1 How to Send Mail Using UltiMail? 

Now you will see what is necessary to send mail to another UltiMail user. 

First of all let's create a new Addressbook : 

1. At the UltiMail client desktop select Actions and than New Addressbook... 




Figure 128. UltiMail Client Addressbook Option 

Now you will be asked for the name of your Addressbook. 



Create New Address book 



j*|julio'8 Address boojk) j 






la x25 1 tsc . I tsc.rale lgh. lbm.o j 





«BBS 

j I^Cawceni* 



Figure 129. UltiMail Client Addressbook Pop-up 



2. Fill the Name: and the Server: fields and click on the OK button. 
The new Addressbook will appear. 
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Figure 130. UltiMail Addressbook 
3. Select the Nick page. 



[£rf Julio's Address book * V ^ |j 




Figure 131. UltiMail Client Addressbook Nickname Creation 

Fill in your mail destination information and click on the Create button. Do it 
as many times as needed to create a complete Addressbook. 

Note: Please note that the Node field is the node where the UltiMail server 
resides. 

4. Close the Addressbook 

5. Now go to the Actions option and select New Letter. 
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You will see a new Letter where you need to fill the necessary fields to 
address to your destination user. 

Let's send a note to the user Gouy telling him about our new experiences 
with UltiMail. 




Figure 132. UltiMail Open New Letter 

Note that the address of the user Gouy is targetting the UltiMail server 
address. You must use the server's machine name to address the users 
logged on to that server. 

6. Click on the Send button to send the letter. 

Now let's see what happened at the UltiMail desktop of user Gouy and see if 
our message arrived OK at its destination. 




Figure 133. UltiMail Client Gouy Desktop 



As you can see the InBox icon has changed, which means that the user has 
new mail. 

7. Double click on the InBox icon 
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Figure 134. UltiMail Client Gouy's InBox 



You should see a closed envelope. Now we need to open the letter. 

8. Double click on the closed letter icon. 

As you can see the letter was sent to the user Gouy and arrived OK at its 
destination. 




Figure 135. UltiMail Open New Letter • Text Part 



You just need to click on the X-OS/2-BMP icon to see the bitmap (BMP) part 
of the note. 




Figure 136. UltiMail Open New Letter - BMP Part 
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9.8 The UltiMail Tutorial 

The UltiMedia Mail/2 Kit comes with a very good tutorial program. Go to this 
item in the UltiMail folder and see what you can do with UltiMedia Mail/2 Kit. 

9.8.1 The Tutorial 

To start the tutorial you have to double click on the Tutorial icon at the UltiMail 
folder. 



I [ij] Ifltimedia Mail/2 - Tutorial 



Welcome 

Welcome to the UltiMail tutorial 

Ultlmedia Mail/2 (short 
UltiMail) is a multimedia e-mail 
system that allows correspondents 
to author, exchange, and 
manipulate formatted text, images, 
animations, audio, video, and 



If you are unfamiliar with 
UltiMail, it is recommended that 
you view the entire tutorial. 

^ To continue, place the mouse 
pointer on the Topics push button 
located at the bottom of the 
window and dick once. 




Figure 137 . UltiMail Tutorial Program 



There are quizzes to check what you have learned. 
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m 

Quiz 1 



UUimedia Mail/2 - Tutorial 



Double -click on the answer: 

Q1. To see the pop* up menu 
associated with an object, you 
place the mouse pointer on the 
object and 

a) click mousebutton 1 

b) click mousebutton 2 

c) double-click mousebutton 1 

Q2. Which one of the pictures on 
the right is the UltiMail 
desktop? 

a) 

38 

c) 

Q3. Where does your incoming 
mail arrive? 

a) In the INBOX folder 

b) In the ALL folder 

cj In the INFO folder 



a) 




Actons Selecte d^ gdit .View Window] 



b) 




Time 



Fron 



Icon Date 

' 7l "4-02-1993 11:07:38 AM MMUS 



agyifirnedia 



a 



Usef's Guide Tutorial Read Me 



© c) 



UMDEMO (logged on) 




Figure 138. UltiMail Tutorial Program Quiz 

The tutorial is a great tool for you start to use the UltiMedia Mail/2 system. 



9.9 SMTP (RFC 822) and MIME (RFC 1521) 

This chapter describes the RFCs that are used by UltiMail to send mail between 
users on the Internet. 

9.9.1 SMTP (RFC 822) 

RFC 822 is a standard for a mail format for use with the Simple Mail Transfer 
Protocol (SMTP). All systems that use SMTP can exchange mail, but each must 
understand certain information, such as the sending and the receiving 
addresses, in order to handle the mail successfully. RFC 822, which is used by 
virtually all SMTP handlers, specifies the format of the mail headers so that they 
may all handle each other's mail. UltiMail uses the RFC 822 standard, and is 
compatible with other such systems. 

9.9.2 MIME (RFC 1521) 

The RFC 822 standard was written when all electronic mail was in plain text 
form, and it handles only plain text. The requirements of multimedia mail and of 
SMTP necessitate extensions to RFC 822. These extensions are in RFC 1521, 
known as Multipurpose Internet Mail Extensions, or MIME. MIME specifies how to 
encode and encapsulate non-text attachments to electronic mail. It defines 
standard ways of packaging one or more separate objects into a message so 
that any MIME-compliant mail system will understand it. The UltiMedia Mail/2 
implementation uses the term "letter" to mean a message, and the term "letter 
part" to mean one of a set of objects in a letter. UltiMail uses RFC 1521 
standard, making it fully compatible with these systems as well. 
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Since MIME is an extension to RFC 822, systems that use MIME can understand 
RFC 822 mail, and systems that use RFC 822, but not MIME, can understand the 
plain text portions of a MIME letter. That makes UltiMedia Mail/2 compatible 
with all RFC 822 systems, even those that don't use MIME. 
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Chapter 10. Remote File Systems 



This chapter describes the installation of NFS, its customization as a server and 
its usage as an NFS client to mount a remote NFS server for OS/2, AIX, VM, 
MVS, and OEM operating systems. 

The test environments for this chapter is shown in 1.4, "ITSC Raleigh Test 
Environments” on page 11. 



10.1 Installing NFS 

The NFS component is contained in the Network File System Kit for TCP/IP V2.0 
for OS/2. You can install it either in addition to the Base Kit, or later on as a 
separate component. In that case, insert the Network File System Kit diskette 
into drive A: and enter: 

ArTCPINST 

You can likewise install the Network File System Kit from a remote drive, using, 
for instance, the remote installation method provided with TCP/IP V2.0 for OS/2, 
or IBM OS/2 LAN Server V3.0. 

Note: The TCP/IP V2.0 for OS/2 Base Kit is a prerequisite for the Network File 
System Kit. 

The OS/2 NFS client is built on the OS/2 Installable File System (IFS) base, and 
therefore an IFS statement must exist in the CONFIG.SYS file of the host on 
which the client runs. If you allow the installation and configuration process to 
modify your CONFIG.SYS file, that statement is added for you. 

The Configuration Notebook allows you to enable your workstation to act as an 
NFS server (NFSD), an NFS client, or both. If you enable the NFS client you can 
also specify remote file systems to mount automatically. 

If you select to enable your machine to function as NFS server, your 
TCPSTART.CMD file is updated to start the PORTMAPPER server and the NFS 
server automatically. The PORTMAPPER server is used to dynamically assign 
port numbers to RPC programs. 

If you select to enable NFS client, the TCPSTART.CMD file will be updated to 
start the NFS client automatically, by adding a call to the NFSSTART.CMD file. 
NFSSTART is a REXX command file which automatically mounts entries defined 
in the \TCPIP\ETC\FSTAB file. It also starts the NFSCTL program which 
communicates with the NFS IFS driver. NFSCTL must be running to mount a 
remote resource as a local drive. 



10.2 OS/2 NFS Client 

The OS/2 NFS client contains several commands to start and maintain the NFS 
client. The available commands are: 

Command Explanation 

NFSC A command file to start the NFS client control program NFSCTL. 

NFSCTL The NFS client control program. 
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MOUNT 



UMOUNT 

MVSLOGIN 

MVSLOGUT 

QMOUNT 



UNIX20S2 

OS22UNIX 

NFSDIR 

SHOWATTR 

SHOWEXP 



SHOWMOUN 



LN 

RPCINFO 



To mount a directory on an NFS server as a local drive. It takes 
advantage of PCNFSD security if it is available on the UNIX server. 
This prevents you from entering UIDs and GIDs on UNIX machines. 
Instead, you give your UNIX user ID and password and it looks up 
your UID and GID. If PCNFSD is not running, MOUNT will prompt 
you for a UID and GID (if you did not enter them on the command 
line). You can use different UIDs and GIDs for different servers. 

Note: The MOUNT command varies, depending on the NFS server 
that you are attempting to mount. When you invoke the 
MOUNT command, the client passes the last portion the 
server without any modifications. The server interprets the 
requested action of the client. See the specific NFS server 
documentation to determine the information the server 
expects from the client on a mount request. 

To unmount previously mounted NFS drives. 

To authenticate an NFS client's access to a data set on a specific 
MVS server. 

To end the session with an MVS NFS server. 

To query the information about mounted drives. LAN shared 
resources, such as drives redirected by IBM OS/2 LAN Server 
V2.0, IBM OS/2 LAN Server V3.0, Novell NetWare, or AS/400 PC 
Support, are also displayed. 

To convert text files from the UNIX format (line ends in a line-feed 
(LF) character only) to OS/2 format (line ends in a carriage-return 
line-feed (CRLF) character sequence). 

To convert OS/2 text files to UNIX format. 

To quickly display a directory from an NFS mounted drive. 

To display the values of file attributes associated with an MVS NFS 
server. 

To display a list of exported file systems for a specific host running 
an NFS server. 

Note: The VM NFS server does not support this command. 

To display a list of all clients that remotely mounted a file system 
at a specified host. This command also lists drives and directories 
that were remotely mounted by clients. This information is 
maintained by the MOUNTD or NFSD server on the host. 

Note: The NFS server machine must support the SHOWMOUN 
protocol to query a list of all clients. The VM NFS server 
does not support this protocol. 

To create a symbolic link on an NFS mounted drive. 

Used to PING remote NFS servers. 



The use of the OS/2 NFS client requires that an NFS server exist somewhere on 
the connected network. 



The FSTAB file specifies the NFS servers that are mounted automatically when 
your NFS client is started. It contains two types of commands: 

• MOUNT 
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• MVSLOGIN 



10.2.1 Configuring the NFS Client using the Configuration Notebook 

The Configuration Notebook is located as TCP/IP Configuration object in the 
TCP/IP folder on your OS/2 desktop. It allows you to configure all TCP/IP 
components and services via a menu interface rather than manually changing 
several configuration files. 

The following shows the first configuration page for NFS: 




Figure 139. TCP/IP Configuration Notebook for NFS, Page 1 

The first NFS configuration page is used for the following parameters: 

Setting Meaning 

Timezone The abbreviation of your time zone, its deviation from 

Greenwich Mean Time, and its optional abbreviation for 
daylight saving time. 

Client UID The user ID when mounting from a UNIX NFS server 

Client GID The group ID when mounting from a UNIX NFS server 

File Permission The bits to determine read/write permissions on files you 
create on a UNIX NFS server. Permission bits are set for: 

1. File owner 

2. Group of file owner 

3. Everyone 

and can have a value from 0 to 7, depending on any 
combination of: 

Read Value of 4 

Write Value of 2 
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Execute Value of 1 

No permission Value of 0 

Directory Permission The bits to determine read/write permissions on 
directories you create on a UNIX NFS server. 

All the settings mentioned above configure the NFS client component and are 
stored in the CONFIG.SYS file. 

10.2.2 Tuning Considerations for the NFS Client 

There are several ways to tune the performance and behavior of an OS/2 NFS 
client, depending on the capability of the NFS server, the quality of the 
communications link, and the demand of the client application. 

The size of a datablock that the NFS client can transfer at a time can range from 
512 to 8192 bytes, the latter being the default value. The rule of thumb is: The 
more reliable and the faster the communications link, the bigger the block size. 
If a communications link is not Reliable or very slow, data blocks may get lost or 
time out, and then the whole block needs to be resent. That is achieved faster 
with a small block than with a larger one. 

The NFS client can use parallel processes (called biods ) to achieve better 
performance for read and/or write requests. The default is four biods, parallel 
read, serial write. This will be sufficient in most cases since NFS writes are 
always slower than reads. 

The RPC timeout and retry values can also be changed if a communication link 
is known to be slow or unreliable. 

The necessary parameters to change these values can be specified with the 
NFSSTART or the NFSCTL commands. See the Network File System Guide for a 
more detailed explanation of NFS client and server commands. 

10.2.3 Mounting an OS/2 NFS Server 

It is assumed that the OS/2 NFS client is successfully started and the 
HOSTNAME environment variable is set. 

To mount an OS/2 NFS server the HOSTNAME, environment variable is passed 
to the NFS server to determine whether your OS/2 NFS client can mount the 
requested directory and with what type of access rights. Therefore an EXPORTS 
file must exist on the remote server. For example, host martin wants to access 
host cidserver's d:\TOOLS directory with read-write access. The NFS server on 
host cidserver has to be started with the following line in the EXPORTS file: 

d:\tools martin 

This means that only host martin has read-write access to the D:\TOOLS 
directory. Nobody else has access. If you want to see which host has which 
access rights to the NFS server cidserver, enter the command: 

showexp cidserver 

and you get the following listing: 

export list for cidserver: 
d:\tools martin 

To mount the D:\TOOLS directory on OS/2 NFS server running on cidserver host, 
as your H: drive, enter the command: 



174 TCP/IP V2.0 tor OS/2 




mount -u -g h: cl dserver: d:\tools 
This results in the following messages: 
mount: cidserver:d:\ 

NFS Drive ■ h: • was attached successfully. 

If you do not enter the -u and -g options, you are prompted to enter UID and GID. 
Since the OS/2 NFS server does not use these values, you may just press the 
enter key. 

A way to automatically mount remote NFS server resources is to create an 
FSTAB file in your \TCPIP\ETC directory. This can be useful if you always have 
to mount the same NFS servers. Assuming you want to automatically mount the 
D:\TOOLS directory of OS/2 NFS server cidserver as your logical drive H:, your 
FSTAB file would look like this: 

mount -u -g h: cidserver: d:\tools 

NFSSTART looks for an FSTAB file at start time and executes the MOUNT 
commands. 

If you want to see which hosts in your network have already mounted the OS/2 
NFS server cidserver, enter the command: 

showmoun cidserver 

This will show you a display similar to the following: 

martin. itsc.raleigh.ibm.com : d:\tools 
martin.itsc.raleigh.ibm.com : d:\doc 

At the same time, all mount requests to an OS/2 NFS server are logged in the 
file \TCPIP\ETC\MTAB. 

After you mount the NFS server you see the resource as an icon in the Drives 
Icon View on OS/2 2.0 or OS/2 2.1. 

In the following picture you see a drives folder with two network drives, N: and 
V:. Drive N: is a mounted AIX drive containing subdirectories; drive V: is a 
mounted VM CMS minidisk. 
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Figure 140. NFS Mounted Drives in the Drives Folder 



You can search files on that drive using the Seek and Scan Files utility of OS/2 
2.0 or OS/2 2.1. You can also copy or move files to and from NFS mounted 
drives using drag and drop as implemented for file and drive objects in the OS/2 
Workplace Shell. 



To see if and what kind of remote file systems are attached to your OS/2 system, 
enter the QMOUNT command; for instance: 



[C:\]qmount 






Type 


Name 


FSDName 


FSAOata 


Local 


C: 


HPFS 




Local 


D: 


FAT 




Local 


E: 


COFS 




Remote 


I: 


EHNSFL0 


RALYAS4B\ 


Remote 


L: 


NETWARE 




Remote 


N: 


NFS 


rs60B07:/u/martin 


Remote 


V: 


NFS 


wtcesa:tcpi pi . 191 , rw,user=tcpi pi ,record=nl 


Remote 


X: 


LAN 


\\WTRNBSRV\TEST 


Remote 

[C:\] 


Y: 


LAN 


\\WTRAS1\MURHAMM 



The example above shows locally and remotely attached file systems: 

• Local drive with HPFS 

• Local drive with FAT 

• Local CD-ROM drive (CDFS) 

• Remote AS/400 PC Support drive (EHNSFLO) 

• Remote Novell NetWare drive (NETWARE) 

• Remote NFS drives (NFS) 

• Remote OS/2 LAN Server drives (LAN) 
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10.2.4 Mounting a VM NFS Server 

The VM NFS server allows an NFS client to mount a VM/CMS minidisk. This can 
be done basically in two modes, binary or with ASCII-to-EBCDIC translation. In 
binary mode, there is no translation at all done. This option is useful if you use 
the CMS minidisk only as additional disk storage for OS/2. The data stored on 
the CMS minidisk will probably be useless to an ordinary VM/CMS user, 
however. 

If you want to share text files among NFS clients and the CMS users, you need to 
use ASCII to EBCDIC translation mode. The NFS server does the necessary 
translation. 

The following example shows how to mount a CMS minidisk in text mode. 



. 

[C:\Jnount -v v: wtcesa:tcpmipl.l91,rw,user=tcpipl,record=nl 
mount : vmesa: tcpmai nt . 191 , rw, user=tcpmai nt 
Enter password: 



NFS Drive 'v: ' was attached successfully. 
[C:\] 



The following screens show an example of copying a file from VM/CMS to an 
OS/2 disk. 

Note: VM/CMS and OS/2 interpret their data differently; VM/CMS is an EBCDIC 
machine, and OS/2 uses ASCII. The data in a CMS file is arranged in 
records, whereas an OS/2 file is a stream of data using a special 
character combination (CR.LF) to indicate record boundaries. The mount 
option record=nl requests this data conversion. The data on the VM/CMS 
minidisk is meaningful for regular VM/CMS users as well as for OS/2 
users. The files stored should also meet the VM/CMS file system 
restrictions. If you want to store executable OS/2 modules (.COM or .EXE 
files) and share these programs with other OS/2 network users, do not 
use the record=n1 option. The data should not be translated; rather it 
should be stored in binary format. 



\ 

[C:\]dir i:ob*.* 

The volume label in drive I is NFS. 

The Volume Serial Number is EAE6:8882 
Directory of I:\ 



7-01-92 


10:53p 


426 


8 


obey, exec 


3-25-92 


5:10p 


243 


0 


obey.fi le 


3-25-92 


5:21p 


81 


0 


obey. stop 


6-25-92 


8:30p 


162 


0 


obey.tcpip 


7-02-92 


11:45a 


11 


0 


obeycmd.tcpip 




5 file(s) 


923 bytes 


used 



7832832 bytes free 



The TYPE command to the TEST.OS2 file shows the following result; 
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\ 

[C:\3type i:test.os2 
This is 

a test 

of 

a VM/CMS file 

[Cs\] 



As you see, there is no order in the records of the file shown at the screen. But 
if you use the UNIX20S2 command you will get the result shown in the next 
screen: 



[C:\]unix2os2 < i:test.os2 
This is 
a test 
of 

a VM/CMS file 
[C:\] 





To copy the file to your local workstation disk, enter the command in the 
following manner: 

[C:\]unix2os2 < i:test.os2 > test.os2 

This all looks very complicated and not user friendly. However the reality 
proved to be less complicated than expected. The OS/2 editor and some other 
editors can handle the missing CR without problems. If you want to edit remote 
files with an OS/2 editor, you have to use the -c option in the MOUNT command, in 
order to suppress the writing of the CR character. 

10.2.5 Mounting an MVS NFS Server 

To use an MVS Version 2.0 NFS server, the client must use the MVSLOGIN 
program to authorize access to the mounted directory. 

You have to use the MVSLOGIN command only once to access files on a particular 
MVS NFS server, even if you mount this MVS NFS server multiple times. 

When you finish accessing files, or have unmounted an MVS mounted NFS drive, 
use the MVSLOGUT command to quit the NFS session with your MVS NFS server. 

To mount an MVS NFS file system it is required to set UNIX.UID and UNIX.GID 
environment variables. The following screens show the activities to be done 
before mounting and to mount an MVS NFS file system. 



[D:\]set unix.uid=-2 
[Dt \] set unix.gid=-2 
[D:\]mvslogin tnvs20 terreld 
Password required 
Enter MVS password: 
terreld logged in ok 

[D:\]M0UNT z: mvs20:tcpip.itsc,text,crlf 
mount: mvs20:tcpip.itsc,text,crlf 

NFS Drive 'z: 1 was attached successfully. 
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To show text files in an orderly manner, you have to set the options text and 
crl f at the MOUNT command. 

Note: The MVSLOGIN and MVSLOGUT commands are not required if the MVS system 
runs the PCNFSD server. To determine whether it does so, run the 
rpcinfo -p command against it. 

The next screen shows the content of the Z: drive. 



^ 

[D:\]dir z: 

The volume label in drive Z is NFS. 

The Volume Serial Number is EAE6:0002 
Directory of Zs\ 



7-15-92 


9:29a 


<DIR> 


0 


• 


7-15-92 


9:29a 


<DIR> 


0 


• . 


7-15-92 


9:29a 


3914 


0 


dig. help 


7-15-92 


9:29a 


5159 


0 


etc. services 


7-15-92 


9:29a 


2976 


0 


ftp. data 


7-15-92 


9:29a 


3526 


6 


hosts. local 


7-15-92 


9:29a 


2495 


0 


lpd.config 


7-15-92 


9:29a 


22960 


0 


mib@desc.data 


7-15-92 


9:29a 


1736 


0 


nslookup.help 


7-15-92 


9:29a 


192 


0 


pw. src 


7-15-92 


9:36a 


6208 


0 


ralvsmv6.tcpip 


7-15-92 


9:30a 


9668 


0 


ralvsmv6.tcpip.distrib 


7-15-92 


9:30a 


8072 


0 


smtp.config 


7-15-92 


9:30a 


193 


0 


smtpnje. host info 


7-15-92 


9:30a 


75 


0 


snmptrap.dest 


7-15-92 


9:30a 


23974 


0 


standard. tcpkj bin 


7-15-92 


9:30a 


768 


0 


standard. tcpxl bin 


7-15-92 


9:36a 


5326 


0 


tcpip.data 


7-15-92 


9:30a 


768 


0 


telnet. tcpxlbin 


7-15-92 


9:30a 


768 


0 


telnetse.tcpxlbin 


20 


file(s) 


99834 bytes used 



61440000 bytes free 



[ [P8\] 



To copy the file snmptrap.dest to the local drive D: the destination filename must 
conform to the destination filesystem restrictions. The following shows the copy 
of the file snmptrap.dest to the local drive D: on host paul: 



[D:\]type z: snmptrap.dest 
9.67.38.93 UDP ; PHILIPPE 

9.67.38.96 UDP ; MVS20 

[0:\]copy z: snmptrap.dest d:\snmptrap.dst 
1 file(s) copied. 

[D: \3 type d:\snmptrap.dst 
9.67.38.93 UOP ; PHILIPPE 

9.67.38.96 UDP ; MVS20 

V J 



You find a detailed description of accessing an MVS NFS server in the MVS's 
Network File System Guide. 
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10.2.6 Mounting an AIX NFS Server 

On the AIX NFS server, you must export the file system to your OS/2 machine. 
To do this, add an entry to the /etc/exports file. The entry must specify a mount 
point, which is the directory to be exported, and can optionally specify a set of 
hosts that have access. 



The following shows how to export a directory from an AIX system using SMIT: 



Session #¥Edit '^Commands ISOption^SjHelp 



licaAdd a Directory to Exports List 



Type or select values in entry fields. 

Press Enter AFTER making all desired changes. 




PATHNAME of directory to export 



MODE to export directory 

HOSTNAME list. If exported read-nostly 

Anonymous UID 

HOSTS alloyed root access 

HOSTS & NET GROUPS allowed client access 

Use SECURE option? 

EXPORT directory now, system restart or both 
PATHNAME of Exports file if using HA-NFS 



Fi=Help 

Esc*5=Urtdo 

F9=Shell 



F2=Refresh 

F6=Command 

F10=Exit 



F3= Cancel 
F7 =Edit 
Enter=Do 



Figure 141 . Exporting a Directory for NFS from AIX 



[Entry Fields] 

[2BEEBSH3SH]] 

read-write 

[] 

[- 2 ] 

F™® 

no 

both 

[] 



F4=List 
F8= Image 



The UID specifies a user ID (UID) on UNIX systems, and the GID specifies a 
group ID (GID) on UNIX systems. These variables are defined when a user ID is 
created. If you want to mount an UNIX NFS server, you have to enter these 
variables. You get the values of these variables if you enter the following 
command at a UNIX command prompt: 

$ grep martin /etc/passwd 

martin: !:202: !:Martin Murhammer:/u/martin:/bin/ksh 
In this example, 202 is the UID and 1 is the GID. 

Note: The considerations above do not apply if the server is running PCNFSD. 

The NFS server can share files based on the FAT (File Allocation Table) or HPFS 
(High Performance File System) system. 

Before mounting an AIX NFS server make sure all NFS daemons are started. 

You can do this by entering the RPCINFO command at an OS/2 command prompt. 
The following screen shows you the result of this command: 
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f [C:\]rpcinfo -p rs68087 



program vers proto 


port 




168689 


2 


tcp 


111 


portmapper 


196696 


2 


udp 


111 


portmapper 


156681 


1 


udp 


1825 


pcnfsd 


186683 


2 


udp 


2649 


nfs 


186695 


1 


udp 


816 


mountd 


168895 


1 


tcp 


812 


mountd 


188924 


1 


udp 


644 


status 


196624 


1 


tcp 


646 


status 


396682 


1 


udp 


649 




396682 


1 


tcp 


651 




188621 


1 


tcp 


962 


nlockmgr 


168821 


1 


udp 


984 


nlockmgr 


166921 


3 


tcp 


967 


nlockmgr 


166621 


3 


udp 


969 


nlockmgr 


169628 


1 


udp 


912 


llockmgr 


168926 


1 


tcp 


914 


llockmgr 


166921 


2 


tcp 


917 


nlockmgr 



Notes: 

1. The RPC INFO command allows you to query the registered RPC programs on 
a remote host. The result shows that the important programs (100000, 
100003, 100005) are running on this RS/6000. 

2. The program 150001 is the pcnfsd server component, which is a user 
verification method for NFS. 

The following example shows how to mount an RS/6000 NFS exported directory 
to the logical drive N: on host martin: 
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\ 

[C:\]showexp rs68007 

export list for rs60007j 
/u/martin martin 

[C:\]mount -s n: rs60007:/u/martin 
mounts rs6000 7: /u/martin 
user name: martin 
password: 

NFS Drive 'n:‘ was attached successfully. 

[C:\]dir n: 



The volume label in drive N is NFS. 
The Volume Serial Number is 1A02:7F95 
Directory of N:\ 



8-03-93 


l:29p 


<DIR> 


0 


• 


7-23-93 


12 : 1 9p 


<DIR> 


0 


• « 


7-21-93 


2:37p 


254 


0 


.profile 


8-03-93 


2:44p 


1518 


0 


.sh_hi story 


7-27-93 


3:56p 


3746 


0 


config.sys 


7-27-93 


4:07p 


3746 


0 


CONFIG.SYS 


8-03-93 


l:35p 


41900 


0 


smit.log 


8-03-93 


l:35p 


4065 


0 


smit. script 


7-29-93 


3:24p 


<DIR> 


0 


.putdir 


8-03-93 


l:29p 


<DIR> 


0 


mount 


10 file(s) 


57277 bytes used 



3751936 bytes free 



[ [C:\] 



Notes: 

1. Using the SHOWEXP command, we get a list of authorized users. 

2. The -s parameter for the MOUNT command tells the NFS server that this client 
requests record locking according to SUN's NLM protocol. Therefore, the 
NFS server must run a file locking daemon, LOCKD, which, as shown in the 
above example for RPCINFO, our RS/6000 does. 

If a server does not run LOCKD, a mount request whith the -s parameter will 
fail. 

3. Because the PCNFSD program is running on the RS/6000 we are asked for a 
user ID and password instead of UID and GID in the mount command. 



10.2.7 Mounting a Novell NetWare NFS Server 

Novell offers a NetWare NFS 1.2b Kit for the NetWare 3.11 Network Operating 
System. The purpose of this extension is to enable UNIX and other TCP/IP 
clients to: 

• Mount drives of a NetWare 3.11 server 

• Use printers of a NetWare 3.11 server 

• Run the NetWare 3.11 Remote Console program either through a Telnet or 
an X Window terminal session, 

and to allow NetWare users {DOS, DOS/Windows, OS/2, Apple) to access UNIX 
and other TCP/IP printers. 

In order to talk to other TCP/IP hosts it is necessary to add the TCP/IP protocol 
to the NetWare 3.11 server. NetWare NFS 1.2b implements the TCP/IP protocol 
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stack as an NLM (Network Loadable Module), and this binds to the network 
board driver also used for NetWare communication (in plain NetWare only the 
IPX protocol stack is bound). 

Once communication is set up, a way to access the NetWare file system has to 
be provided. The NetWare file system is a proprietary one that is optimized for 
file I/O performance as needed in a file server environment. To enable clients to 
access that file system, so called Name Spaces have been introduced. These 
Name Spaces map the filename conventions of client file systems to the NetWare 
file system: 

• filename.ext for DOS and OS/2 FAT: "8.3" 

• filename for OS/2 HPFS: up to 254 characters plus extended attributes 

• filename for UNIX: up to 255 character, mixed case and case sensitive. 

NetWare NFS 1.2b adds NFS as a Name Space to the NetWare operating system. 

To support mount requests from NFS clients, the NetWare NFS server must be 
configured to: 

• Export directories for mounting 

• Authenticate users before granting access to exported directories. 

To add authorized users and exported directories to the NetWare NFS server, 
start the NFS administration program on the NetWare server, either locally or 
through Remote Console: 

load nfsadmin 

You can set up separate NFS user IDs and passwords, or you can use existing 
NetWare user accounts for NFS. 

Specifying directories for exports is done in a similar way as on a UNIX system. 

On an OS/2 NFS client, use the SHOWEXP command to see what directories are 
exported by a particular NetWare NFS server. Use the MOUNT and UMOUNT 
commands to access and stop accessing a NetWare NFS server. The following 
figure shows: 

• Remote Console to a NetWare 3.11 server via an X Window terminal session 

• Exporting a directory from a NetWare NFS server using NFSADMIN. 
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X: NWPS81 NetWare Console (1) 







NFS Rctainistration Version 2.0 


NetWare 386 Loadable Module 




Figure 142. Configure NetWare NFS Export Directories 



10.2.8 Mounting a DEC/VMS NFS Server 

The DEC VMS operating system has neither TCP/IP nor NFS capability, but it can 
be added by the MultiNet application. MultiNet will run on top of VMS and 
provide TCP/IP and NFS in addition to DECNET. The following shows an OS/2 
NFS client mounting a drive from a DEC MicroVAX after having verified that a 
drive is actually exported: 
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[C : \t cpi p\tmp]showexp dec 
export list for dec: 

/dia0$dia0/itscuser everyone 

[C:\tcpi p\tmp]mount d: dec:/dia0$dia0/itscuser 
mount: dec:/dia0$dia0/itscuser 
user name: system 
password: 

NFS Drive 'd: ' was attached successfully, 
[C:\tcpip\tmp]d: 

[D:\]dir *♦ 

The volume label in drive D is NFS, 

The Volume Serial Number is 0000:002A 
Directory of D:\ 



8-25-93 


6:17p 


<DIR> 


0 


• 


8-25-93 


6:17p 


<DIR> 


0 


« . 


8-25-93 


6:17p 


<01 R> 


0 


nfsclient 


8-25-93 


6:17p 


<01 R> 


0 


os2#test 


8-25-93 


6:17p 


<01 R> 


0 


os2client 


6-18-93 


8:59a 


569 


0 


prueba 


6-09-93 


18:43a 


26 


0 


titin 




7 file(s) 


4173 bytes used 



111111168 bytes free 



l DM1 



10.3 OS/2 NFS Server 

To mount a directory on an OS/2 NFS server, you must export the OS/2 file 
system. To do this, add an entry in the \TCPIP\ETC\EXPORTS file on the NFS 
server. 

Notes: 

1. If you use the NFS server on a FAT drive, file names are restricted to the 
FAT 8.3 format and must be in uppercase. 

2. If you use the NFS server on an HPFS drive, file names can be up to 254 
characters in length. Files are stored with the same name you specified 
during creation (including upper and lowercase). 

3. The OS/2 NFS server does not support SUN's NLM protocol for record 
locking. 

4. NFS does not support HPFS extended attributes. If you need to copy files 
with extended attributes to an NFS mounted drive, make sure that you 
extract all extended attributes first using the OS/2 EAUTIL command. EAUTIL 
will extract extended attributes from HPFS files and place them in a separate 
file that needs to be copied along with the files. The same command can 
later be used to attach extended attributes back to their original files. 

For the OS/2 NFS server martin the following EXPORTS file was created: 

#DIRECT0RY CLIENTS COMMENT 

c:\tcpip\tmp martin miers murphy dos20 os25 cidserver rs60007 #Share 
c:\tools -ro martin miers murphy dos20 os25 cidserver rs60007 #Too1s 
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10.3.1 Configuring the NFS Server using the Configuration Notebook 

The Configuration Notebook is located in the TCP/IP folder on your OS/2 desktop. 
It allows you to configure all TCP/IP components and services via a menu 
interface rather than manually changing several configuration files. 

The following shows the second configuration page for the NFS: 




Figure 143. TCP/IP Configuration Notebook for NFS, Page 2 

The second NFS configuration page is used for the following parameters: 

Setting Meaning 

Exports directories Directories that are to be exported by the NFS server to other 
NFS clients. 

FSTAB file MOUNT and MVSLOGIN commands to be executed when the NFS 

client is started, in order to automatically mount remote file 
systems. 

The FSTAB file, contained in the \TCPIP\ETC directory, is a configuration file for 
the NFS client, whereas the EXPORTS file (contained in the same directory) 
configures the NFS server. The following shows the dialog to add a directory to 
the EXPORTS file: 
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Figure 144. EXPORTS File Configuration 

Setting Meaning 

Directory Directory to be exported 

Access Access permission for exported directory 

Client Hosts authorized to access exported directory 

Comment Optional comment for exported directory 

The following screen shows the OS/2 NFS Server: 



IBM OS/2 NFS Server Version 1.2 (Jul 19 1993) 



NFS: File ownership set to uid 0, gid 0. 

NFSD: Initialization complete. Server running. 



Since the NFS server is stateless, you can never find out who is mounting your 
server at a certain point of time. The only thing you can see is whoever 
mounted directories at your server. This will be logged in the 
\TCPIP\ETC\MTAB file, as shown for host cidserver in the following example: 

[C:\tcpip\etcjtype mtab 
d:\cid martin.itsc.raleigh.ibm.com 
d:\doc mi ers . i tsc . ral ei gh . i bm . com 

d : \book mi ers . i tsc . ral ei gh . i bm . com 



10.3.2 Mounting from an IBM TCP/IP for DOS NFS Client 

The IBM TCP/IP for DOS NFS client has the following commands available: 



MOUNT 

NFSDOWN 

NFSSET 

SHOMOUNT 

TOUNIX 



MVSLOGIN 

NFSPING 

NFSSTAT 

SHOWEXP 

UMOUNT 



MVS LOG UT 
NFSPRINT 
OMOUNT 
TODOS 
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For a detailed description of these commands refer to IBM TCP/IP Version 2.1 for 
DOS User's Guide. 

Before you can use NFS, you need to load, enable, and configure the DOS NFS 
terminate and stay resident (TSR) program. To do this you can use the CUSTOM 
utility to customize your DOS TCP/IP environment. Once NFS is started you can 
enter NFS commands. 

To mount the D:\TOOLS drive of OS/2 NFS server cidserver as your F: drive 
enter the command: 

mount -i -u -g f: cidserver:d:\tools 

Now you can use cidserver's D:\TOOLS directory as your F: drive, subject to any 
access rights stated by the NFS server. 

10.3.3 Mounting from an AIX NFS Client 

To run the mount command on an AIX NFS client, you must have root user 
authority or be a member of the system group. This is because mounting an 
NFS or other file system affects the file system for all users on the AIX machine. 

Considering the OS/2 NFS server's read and write buffer size, the AIX mount 
command should be entered with the following options: 

• rsize=4096 

• wsize=4096 

The mount of host martin's C:\TOOLS directory to the /u/martin/mount mount 
point is shown on the following screen using SMIT: 



Session -'Edit ^Commands 'Options Help 



lica Add a File System for Mounting 

[Type or select values in entry fields. 
jPress Enter AFTER making all desired changes. 

[TOP] 

* PATHNAME of mount point 



PATHNAME of renote direct on 



HOST where remote directory resides 

Mount type NAME 

Use SECURE mount option? 

MOUNT now, add entry to /etc/filesystems or both? 
/etc/filesystems entry will mount the directory 
on system RESTART. 

MODE for this NFS file system 
ATTEMPT mount in foreground or background 
HUMBER of times to attempt mount 
Buffer SIZE for read 
Buffer SIZE for writes 
[MORE... 28] 



iFUHelp 
Esc* 5= Undo 
F9=Shell 



F2=Refresh 

F6=Command 

F10=Exit 



F3= Cancel 

F7=Edit 

Enter=Do 




F4=List 

F8=Image 



a 



Figure 145. Exporting a Directory for NFS from AIX 

The following shows how an NFS mounted OS/2 drive's files can be listed under 
AIX: 
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$ pwd 
/u/martin 
$ cd mount 
$ pwd 

/u/martin/mount 
$ Is -la L* 

-rw-rw-rw- 1 root system 4243 Feb 93 1991 LICENSE. 00C 

-rwxrwxrwx 1 root system 14168 Jan 14 1993 LOADDSKF.EXE 

-rwxrwxrwx 1 root system 22788 Apr 23 1991 L0ADRAM2.EXE 

-rw-rw-rw- 1 root system 37851 May 89 1991 L0ADRAM2.INF 

$ 

To unmount a remote file system enter the umount command. For example to 
unmount all mounted file systems from OS/2 NFS server martin enter at the AIX 
command prompt: 

umount -n martin 

10.3.4 Mounting from a DEC/VMS NFS Client 

The following shows a DEC/VMS system that has been added the NFS client 
function by the MultiNet application mounting a drive from an OS/2 NFS server: 



r 

$ multi net nfsmount 


cidserver::"d:\cid" os 2 










\ 


%NFSMOUNT-I -MOUNTED 


CIDSERVER: :d:\cid NFS mounted on NFS2: 








$ show devices /mounted 












Device 


Device Error 


Volume 


Free 


Trans Mnt 


Name 


Status Count 


Label 


Blocks Count 


Cnt 


DIA9SDIA0: 


Mounted 


e 


USER2 


217014 


41 


1 


DUA 8 : 


Mounted 


e 


VMSRL5 


46473 


149 


1 


DUA1: 


Mounted 


6 


USER1 


138621 


1 


1 


NFS2: 


Mounted 


0 


d:\cid 


216356 


1 


1 


$ set default os 2 ;[-] 












$ dir /protection 














Directory 0S2: [ 868888 ] 












060000. DIR;1 


(RWED , RWED , RWED , RWED) 












DEC* ;1 


(RWED , RWED , RWED , RWED) 












EXE • DIR; 1 


(RWED. RWED, RWED, RWED) 












IMG.DIRjl 


(RWED, RWED, RWED, RWED) 












LOG.DIRjl 


(RWED, RWED, RWED, RWED) 












MAIL.MAI;1 


( RWED , R WD , RWD , RWD ) 












PMGRAB0O.PSE;1 


(RWED , RWD , RWD , RWD ) 












RSP*DIR;1 


(RWED, RWED, RWED, RWED) 












SETUP.CMD ; 1 


(RWED, RWED, RWED, RWED) 












STARTNET.LOG;! 


(RWED, RWD, RWD, RWD) 












STARTUP. CMD;1 


(RWED, RWED.RWED, RWED) 












WELCOME. TXT;1 


(RWED, RWD, RWD, RWD) 












X25.CMD;! 


(RWED, RWED, RWED, RWED) 












X25DIR. ;1 


(RWED, RWED, RWED, RWED) 












X25I0. ;1 


(RWED, RWED, RWED, RWED) 












X25IP. ;1 


(RWED, RWED, RWED, RWED) 












X25RTE • 5 1 


(RWED, RWED, RWED, RWED) 












Total of 17 files. 

% 












J 
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10.4 Interoperability with IBM OS/2 LAN Server V3.0 

This section describes how IBM OS/2 LAN Server V3.0 shares NFS mounted 
drives. 

The following figure illustrates the scenario: 



TCP/IP 

NetBIOS 



OS/2 LAN Server 3.0 and 
TCP/IP 2.0 for OS/2 NFS Client 



Shared LAN Server file alias 

_.!•* Mounted NFS Drive 

' shared as LAN Server file resource 



RS/6000 
AIX NFS Server 



Exported NFS Drive 




TCP/IP for OS/2 NFS Client 
or 

TCP/IP for DOS NFS Client 



□ OS/2 LAN Requester 3.0 
or 

kjjg DOS LAN Requester 3.0 



OS/2 LAN Requester 3.0 and 
TCP/IP for OS/2 NFS Client 
or 

DOS LAN Requester 3.0 and 
TCP/IP for DOS NFS Client 



Figure 146. IBM OS/2 LAN Server V3.0 Sharing NFS Mounted Drives 



10.4.1 IBM OS/2 LAN Server V3.0 Sharing NFS Mounted Drives 

In this case, a system running IBM OS/2 LAN Server V3.0 also runs the NFS 

client from TCP/IP V2.0 for OS/2. You should follow the above steps for sharing 

NFS mounted drives: 

1. Start IBM OS/2 LAN Server V3.0 
net start server 

2. Start the NFS Client 
nfsstart 

3. Mount the NFS drive 
mount n: rs600O7:/u/mart1n 

4. Share the NFS mounted drive with IBM OS/2 LAN Server V3.0. 
net share nfslan=n: 

The following should be observed when establishing this scenario: 
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1. You must have administrator privileges for IBM OS/2 LAN Server V3.0 

2. NFS maps root to [-2,-2]. If you mount another user's home directory, you 
should have its UID and GID. 

3. You should mount the remote NFS drive using root access permission or 
equivalent. Remember that giving NFS client root permission could be a 
serious security problem. 

This scenario does not work in the opposite direction (that is, making an OS/2 
NFS server exporting a drive that has previously been redirected using OS/2 
LAN Requester will result in an error during mount). 
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Chapter 11. X Windows System Server (PMX) 

This chapter describes the installation of PMX, its customization and usage to 
run X Window System client applications from OS/2, AIX, and VM operating 
systems. 



11.1 The X Window System 

The X Window System is a distributed, window-based graphics system 
developed at Massachusetts Institute of Technology. The X Window System 
Server Kit of TCP/IP V2.0 for OS/2 supports Version 11 Release 5 (X11R5) of the 
X Window System server (X server) function. 

The X server is a dedicated program that provides display services on a graphic 
terminal at the request of an X client program. An X client is the actual 
application program that sends its output to an X server in order to provide a 
graphical user interface. X clients send their output to remote X servers using 
TCP/IP as a transport. X clients can also run on an operating system different 
from the one of the X servers where they send their data to. The following 
shows the basic concepts of the X Window System. It illustrates where the 
necessary steps are performed to run the Xcalc application: 

Host A Host B 



X Client X Server 









... 




start X server 


... 


start X client appl. 




... 


◄ 


Xcalc 


initiate Appl. 




• • • 


■Xcalc" 


send application output 


* ♦ • 


• * • 


fr. 


display output 


wait 




• • • 


• • . 


send user input 


... 


. . . 


4 


get input 


process input 


• ♦ ♦ 


... 


• • . 


9*9 


• • • 



local transport: Inter Process Communications 

remote transport: TCP/IP 

Figure 147. The X Window System Concept 

Since many X clients can compete for an X server to display their data, an X 
Window manager is employed to resolve service conflicts. 

PMX uses OS/2 Presentation Manager as the X Window manager and supports 
all of the keyboard, display, and pointer devices that are supported by OS/2 PM. 
Using PM as the X Window manager enables OS/2 PM windowed applications 
and X client applications to share the same screen. As a result, another window 
manager (as for example, aixwm or Motif) cannot act as the window manager for 
the OS/2 X server. 



© Copyright IBM Corp. 1990 1992 1993 
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The TCP/IP V2.0 for OS/2 X Window System server support comprises the 
following components: 

• X Window System Server (PMX.EXE) 

• X Window System Font Support 

• X Window System Utilities 

• National Language Support for Keyboards 

The test environments for this chapter is shown in 1.4, “ITSC Raleigh Test 
Environments" on page 11. 



11.2 Installing and Configuring the X Window System Server 

The X Window server component is contained in the X Window System Server 
Kit for TCP/IP V2.0 for OS/2. You can install it either in addition to the Base Kit, 
or later as a separate component. In that case, insert the X Window System 
Server Kit diskette number 1 into drive A: and enter: 

AiTCPINST 

You can likewise install the X Window System Server Kit from a remote drive, 
using, for instance, the remote installation method provided with TCP/IP V2.0 for 
OS/2, or IBM OS/2 LAN Server V3.0. 

Notes: 

1. The TCP/IP V2.0 for OS/2 Base Kit is a prerequisite for the X Window System 
Server Kit. 

2. The X Window System Server Kit requires 11.7MB of disk space. 

3. The X Window System Server Kit requires a large amount of memory. You 
should have 8MB of memory on your machine and about 10MB of swapping 
space on your hard disk, though the real amount of memory required by 
PMX depends on the X client applications that you are using. 

The required files for the X Window System Server Kit are installed into the 
TCP/IP V2.0 for OS/2 product directory structure by default. Many X server 
database files required by the X server software for initialization and operation 
are installed in a subdirectory named \TCPIP\X11 by default. 

After installing the X server support, you can use the TCP/IP Configuration 
Notebook or use PMX Configurations, Initial/Current Settings to customize the X 
Window System server to your requirements: 

11.2.1 Configure PMX using the TCP/IP Configuration Notebook 

The Configuration Notebook is located as the TCP/IP Configuration icon in the 
TCP/IP folder on your OS/2 desktop. It allows you to configure all TCP/IP 
components and services via a menu interface rather than manually changing 
several configuration files. 

You can also get to the configuration pages for PMX from the running X server 
command Configuration .Settings. 

The following section briefly explains the eight configuration pages for PMX: 
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Figure 148. TCP/IP Configuration Notebook for PMX, Page 1 



The first PMX configuration page is used for the keyboard parameters: 

Setting Meaning 

Keyboard Type Specify the type of keyboard that is attached to your 
workstation. 

See 11.3, “National Language and Keyboard Support for PMX” on page 203 for 
more details on PMX keyboard support. 




Figure 149. TCP/IP Configuration Notebook for PMX, Page 2 
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The second PMX configuration page is used for the focus and raise parameters: 

Setting Meaning 

Focus Controls Specify the preferred action to bring the focus to a PMX 
window on your OS/2 desktop. The normal behavior of 
OS/2 Presentation Manager is "Click in window for focus", 
whereas the default behavior of the X Window System is 
"Move pointer into client area for focus". 

Raise Controls Specify the preferred action to raise a PMX window to the 
top of the OS/2 desktop. 




Figure ISO. TCP/IP Configuration Notebook for PMX, Page 3 

The third PMX configuration page is used for the authorization parameters: 

Setting Meaning 

X Host Authorization Specify a list of host names that are allowed to send X 

client data to your X server. The entries are saved in the 
\TCPIP\ETC\XOHOSTS file. 
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Figure 151. TCP/IP Configuration Notebook for PMX, Page 4 

The fourth PMX configuration page is used for the cursor parameters: 

Setting Meaning 

Cursor Dimensions Specify the size of a cursor. 

Cursor Selection Specify the type of cursor that you want X server to use 

when displaying X client windows, and its color options. 
(The PM cursor is an arrow tilted towards the upper left 
corner; the X Window System cursor is is an arrow tilted 
towards the upper right corner). 

Cursor Font name Specify the cursor font to use for PMX. 
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Figure 152. TCP/IP Configuration Notebook for PMX, Page 5 



The fifth PMX configuration page is used for the color parameters: 

Setting Meaning 

Color Visual Specify how you want PMX to handle colors for X 

clients. 

Number of reserved colors Specify the number of colors to be reserved for color 

tables. 

Color Database file Specify the file that holds the color database 

See 11.8, “PMX Color Table Support" on page 209 for more details on PMX color 
support. 
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Figure 153. TCP/IP Configuration Notebook for PMX, Page 6 

The sixth PMX configuration page is used for the fonts parameters: 

Setting Meaning 

Default font path Specify where PMX is to find the default fonts that it will 
use to display X clients' data. 

Default font Specify the default font that PMX is using. 

See 11.9, “Customizing X Window System Fonts” on page 210 for more details 
on PMX font support. 
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Figure 154. TCP/IP Configuration Notebook for PMX, Page 7 

The seventh PMX configuration page is used for the cut and paste ps ‘imeters: 

Setting Meaning 

X Data Transfer Mechanism Specify whether and how you want to transfer data 

between Presentation Manager and X Window 
System client applications. 

X Data Transfer Timeout Specifies how long PMX has to wait for data that it 

has requested from an X client for data transfer. 

See 11.7, “PMX Clipboard Support” on page 208 for more details on PMX 
clipboard support. 
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Figure 155. TCP/IP Configuration Notebook for PMX, Page 8 

The eighth PMX configuration page is used for miscellaneous parameters: 

Setting Meaning 

Minimize Specify whether you want PMX to start minimized on your 

desktop 

Cascade Specify whether PMX should cascade X client windows. 

Autorepeat Specify whether PMX should turn on automatic repetition of 
keys. 

Copyright Specify to display a copyright information when PMX starts. 

Log file path Specify where to write the PMX. LOG file 

For a more detailed description of PMX configuration settings, see Chapter 2 in 
the X Window System Server Guide, SC31-7070-00. 

11.2.2 Starting the X Window System Server 

To start the OS/2 X Windows System server, you have three options: 

1. XINIT.CMD 

2. PMX. EXE 

3. Double click on PMX icon/object 

XINIT.CMD is a REXX command file that checks your environment prior to start 
the X server, and it sets the correct NLS keyboard and other configuration 
attributes. The PMX command starts the X server explicitly. 

Note: If there are problems loading PMX, check if you have a RESOLV file 

created and if the name server defined there is up and running. If you do 
not have a name server in your network, delete the RESOLV file. 

Both commands take the settings described in the previous section as default or 
optional parameters, and they both rely on the following OS/2 environment 
variables to control server functions: 
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Variable Explanation 

XFILES If you allow your CONFIG.SYS file to be updated, the installation 

program sets the environment variable XFILES to the XII subdirectory 
path. The X server software, PMX.EXE, references the XFILES 
environment variable to locate the database files. If XFILES is not set 
properly, PMX.EXE fails to execute. The default is \TCPIP\X11. 
DISPLAY This variable is required by the X Window System utilities. It is set 
automatically to point to your host name or IP address and has the 
format: 

hostname: 8 
or 

IP_address:0 

where 0 denominates the first X server on your host (you will 
normally have only one). 

LANG This environment variable selects the proper NLS keyboard for X 
client applications. 

ETC This environment variable is already set by the TCP/IP V2.0 for OS/2 
Base Kit (usually to \TCPIP\ETC). It tells PMX where to look for the 
XOHOSTS file. 

Once the X server is started and has finished initializing the X Window System, it 
runs as an OS/2 Presentation Manager application on your desktop. It will 
display a Ready for Clients message during normal operation. The following 
figure shows the PMX main window with open commands menu: 




Figure 156. PMX Server Main Window 

Setting Meaning 

Configuration Leads you to the PMX Configuration Notebook. You can 

change either the initial PMX settings (all) or settings 
that would influence the currently running server (some). 

Save position and size Saves the position and size of the PMX main window on 

the OS/2 desktop. 

Refresh all clients Repaints all PM windows which includes X client 

applications. 

Restore Original Colors Restores the original color table of all running PM 

applications. 

Cut/Paste Transfers data between Presentation Manager and X 

Window System clients. 
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Raise lowest window Brings the lowest X client window to the top. 

Lower highest window Brings the top X client window to the background. 

Exit Ends PMX. 

Please see the X Window System Server Guide, SC31-7070-00 for a more detailed 
description of the PMX server environment variables. 



11.3 National Language and Keyboard Support for PMX 

PMX supports national language keyboard definitions as well as different 
keyboard layouts. 

PMX uses the XMODMAP utility to set up your keyboard for the language of the 
different countries. Therefore you have to define the LANG environment variable 
and the appropriate language keyboard value at the PMX Configuration 

Notebook. 

The command set LANG=de_DE sets the LANG environment variable to German 
keyboard and the following commands start the X Window server: 



[C:\]set lang=de_DE 
[C:\]xinit 

[C:\]pmxwait -q 0 

PMX Server is not ready! rc(l) 

XX1G1 XX 

[C:\] START PMX.EXE -nocopyright -fp C:\TCPIP\Xll\misc, C:\TCPIP\Xll\75dpi -k 102 

[C:\]pmxwait -v 60 
Waiting for 60 seconds. 

PMX Server is ready! 

[C:\]xmodmap C:\TCPIP\XH\DEFAULTS\XMODMAP\DE_DE\keyboard 
[C:\] 

/ 



You can see the result of this input on the following screen which shows an X 
terminal having a German NLS keyboard layout: 



-SX'isaixterm 



$ 

$ astt m & \}][{ 23 @n_ 




Figure 157. X Server National Language Support 



To select a different country keyboard, the following table shows the available 
variables for the appropriate language: 
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Language 


Keyboard 


Language 


Keyboard 


Belgian 


nl_BE 


Belgian French 


fr_BE 


Canadian French 


fr_CA 


Danish 


da_DK 


Dutch 


nlJIL 


Finnish 


fi-FI 


French 


fr_FR 


German 


de_DE 


Greek 


el_GR 


Icelandic 


is_IS 


Italian 


itJT 


Japanese 


ja_JP 


Japanese English 


en_JP 


Latin American Spanish 


es_LA 


Norwegian 


no_NO 


Portuguese 


pt_PT 


Spanish 


es_ES 


Swedish 


sv_SV 


Swiss French 


fr_CH 


Swiss German 


de_CH 


Turkish 


tr_TR 


United Kingdom 


en_GB 


United States 


en_US 







PMX supports different physical types of keyboards apart from NLS layouts. 
Supported keyboard types are: 

• 101 keys (for example US keyboard) 

• 102 keys (for example German keyboard) 

• 106 keys (Japanese 5576-A01 or 5576-002) 

• 124 keys (Japanese 5576-001) 



11.4 Using the X Window System Server on OS/2 

In order to be able to send data to your X server, the host systems where those 
X client applications are run need to be authorized at your host. This can be 
done via the XOHOSTS file statically, or with the XHOST utility dynamically. 

You can disable X client authorization by uncommenting the line: 

/* 'xhost +' */ /* DISABLE PMX access control */ 

in your XINIT.CMD file, thus allowing any host to send X client data to your X 
server. 

This can be done with a "+* entry in XHOSTS in the configuration notebook. 

X Window clients can be executed from a Telnet session with a remote host. 

The DISPLAY environment variable must either be defined in the user profile on 
that system for the current user, or it must be specified as an option to the X 
client command, if the applications supports that. The following command starts 
an X client window from an RS/6000 under AIX: 

aixterm -d 9.67.38.81:0 & 

By specifying the display variable, you can send an X client's output to any host 
on the network. You will get an error message if that host cannot be reached, or 
if your host is not authorized to use the designated X server. 

Another possibility to start an X client is via the REXEC command instead of a 
Telnet session. For example: 

rexec rs60007 -1 martin -p martin xcalc -display 9.67.36.81:0 
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or if you created the appropriate NETRC file to support the REXEC command: 
rexec rs60007 xcalc -display martin:0 

The NETRC file on host 9.67.38.81 has the following entry to execute remote 
commands on host rs60007: 

machine rs60007 logonid martin password martin 

In the sample below we started an AIX X terminal from an RS/6000 using REXEC: 
rexec rs60007 aixterm -d martin :0 

Since the display variable points to the OS/2 PMX server (-d martin :0), the 
graphic output will be displayed on the OS/2 server martin. From within that 
aixterm session, three more X Window System client applications were started: 

1. AIX Power Desktop 

2. AIX System Management Interface Tool (SMIT) 

3. AIX Info Explorer. 

We used an Image Adapter /A with an attached 6091-19 display on our PS/2 to 
give the OS/2 system the look and feel of an AIX X Station, as shown in 
Figure 158 on page 206. 
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LINEN0=1 
LINES=25 

LOCPATH=/usr/lib/nls/loc 
LOGNAME=mart in 
MAILCHECK=600 

NLSPATH=/usr/l ib/nls/msg/j5L/JJN : /usr/ 
ODMDIR=/etc/objrepos 

PATH= : /usr/ucSSl^irf^H 

PPID=16284 i Exit Edit gmr 

TC9°^ ig^H To; 

PS3=#? “ 

ps 4=+ pjggl feMHfil J jl MR 
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Figure 158. Execute AIX X Window System Clients on OS/2 
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11.5 VM X Windows Clients 

TCP/IP for VM has an X Window API and some sample applications in source 
code. These programs need to be compiled first, since they are shipped in 
source code only. There are two procedures in VM that compile all the utilities 
and samples (XCLIENT and XSAMP). 

Before you start the client on the VM system, you need to define the DISPLAY 
variable and some libraries. We did this in the PROFILE EXEC file that looks like 
the following: 

trace o 
•ACC 591 E' 

'ACC 592 F' 

•LINK TCPMAINT 5C3 5C3 RR' 

■LINK TCPMAINT 5C4 5C4 RR' 

'ACC 5C3 G' 

'ACC 5C4 H' 

'SET LDRTBLS 25' 

'GLOBAL TXTLIB X11LIB COMMTXT IBMLIB CMSLIB EOCBASE ' 

'GLOBAL LOADLIB EDCLINK' 

■GLOBALV SELECT CENV SET DISPLAY 9.67.38.81:0.0' 

Now you can run, for instance, the XLOGO program by typing xlogo at a VM 
CMS command line, but make sure that you have enough storage assigned to 
your CMS session. The XLOGO program, for instance, requires at least 4MB of 
system storage. The following window shows up on your OS/2 desktop: 




U ■ UlinUL ■»!! 

Storage cleared - system reset, 
i eras 

19E replaces V (19E) 

V tl9E] R/0 

CHS 0 03/25/92 fSI H-Hfla*rnr) 




(19F) 
Ready: 1 
xlogo 
Uarning: 








Figure 159. VM X Window Client XLOGO 
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11.6 X Window System Utilities 

The X Window System Server Kit provides several utilities to control and 

configure the X server environment: 

Utility Function 

PMXWAIT Tests whether PMX is ready to accept client connections within a 
specified time period. 

XEV Creates a test window to see how PMX responds to user input. 

XFD Creates a window in which the characters of a font are displayed. 

XHOST Dynamically adds or deletes hosts from the list of hosts that are 

allowed to use your X server. It can also be used to disable X 
client authorization entirely. 

XLSFONTS Displays information about the fonts used by PMX. 

XMODMAP Displays or changes the keyboard map and table of key synonyms 
for the X Window System. This utility can also be used for 
keyboard remap. 

XPROP Displays the window and font properties of an X window. 

XSCOPE Displays the X Window System protocol activity between X clients 

and PMX. 

XSET Dynamically changes the behavior of PMX 

XSTDCMAP Selectively defines the colormap properties for X clients. 

XWININFO Displays information about X client applications. 

Please see Chapter 3 in the X Window System Server Guide for a more detailed 

description of the PMX server utilities. 



11.7 PMX Clipboard Support 

The OS/2 X server supports copying data between OS/2 Presentation Manager 
and X Window System applications using cutting, copying, and pasting. You can 
specify the way you want data transfer between PM and PMX to be handled on 
page 7 of the PMX Configuration Notebook: 

Transfer Option Description 

Turn Off PMX Cut/Paste Disables data transfer between PM and X Window 

System applications. 

Cut Buffer (Text only) Allows you to share text data between PMX and PM. 

PMX monitors the contents of an X Window System 
buffer called CUTBUFFERO. If an X client cuts or copies 
data, that goes into that buffer. Once the contents of the 
cut buffer change, PMX transfers that data to the PM 
clipboard where it is then available to OS/2 applications. 

When an X client wants to paste data from CUTBUFFERO, 
PMX checks the PM clipboard. If there is text data 
there, PMX transfers it into the cut buffer so that the X 
client can use it. 
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Selection Names 



Allows you to share any type of data between PMX and 
PM based on a transaction-oriented mechanism. When 
PMX starts, it becomes the owner of one of the following 
selection names: 

1. PRIMARY 

2. SECONDARY 

3. CLIPBOARD 

When an X client cuts or copies data using the selection 
mechanism, it takes ownership of the selection name 
from PMX. PMX then requests the data from the X client 
and places it on the PM clipboard. 

When an X client wants to paste data using the selection 
mechanism, it requests data from the owner of that 
selection name, which in our case is PMX. PMX then 
transfers data from the PM clipboard to the X client, 
provided that it is there and matches the requested data 
format. 

Please see Chapter 2 in the X Window System Server Guide for a more detailed 
description of how PMX handles data transfer to and from Presentation Manager. 



11.8 PMX Color Table Support 

The OS/2 X server supports the modification of physical colors on the screen by 
applications. While Presentation Manager applications usually do not do that, X 
client applications may need this capability to function properly. In fact, this Is 
very common within the X Window System environment. 

OS/2 Presentation Manager supports color tables (which cannot be modified), 
and color palettes (which can be modified). The X Window System supports 
color maps (the same as color tables and color palettes in PM) and color 
visuals. Color visuals are specific types and depths of color maps that are 
supported by the combination of an X server and a display adapter. The depth 
of a visual is the number of bits available to represent a color or grey shade; a 
visual with a depth of 5 would have 32 shades of grey, a color visual with a 
depth of 8 would have 256 colors. 

The default color table (color database) that PMX uses is the RGB.TXT file in the 
\TCPIP\X11 directory. It is a plain ASCII file holding values for the red, green, 
and blue components of a color, and a name for that color. You can make 
changes to this file or create your own color database, but be aware that PMX 
reads this file at startup and does not dynamically adapt to changes. PMX maps 
these values into PM color tables and palettes. 

PMX supports the following color visuals: 

Visual Explanation 

StaticColor In this visual, colors cannot be changed. Only one color table is 
available which contains the colors of the physical color table of 
the display. If an application asks for a color (an RGB value) 
that is not in the table, it is pointed to the color that is closest to 
the one requested. Presentation Manager supports such a 
nonmodifiable color table for all displays, hence PMX does as 
well. 
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Pseudocolor In this visual, PM uses modifiable color palettes rather than a 
static color table. These are called Pseudocolor maps in the X 
Window System. If an application selects such a table, it can 
allocate colors in the default Pseudocolor table until there is no 
more room for colors, or it can create tables and control the 
contents of those. PMX queries PM to see if the display has 
support for the Palette Manager before it starts using the 
Pseudocolor visual. 

The depth of either color visual is dependant upon the display driver that is used 
with Presentation Manager, as shown in the following table: 



Table 1 U PM and PMX Color Support 


Display 


Depth 


Colors 


Pseudocolor 


VGA 


4 


16 


no 


8514/A 


8 


256 


yes 


SVGA 


8 


256 


yes 


XGA-2 


8 


256 


yes 


Image Adapter /A 


8 


256 


yes 



When you use Pseudocolor, the color table being used is that of the application 
being brought to the top of your OS/2 desktop. If that application happens to 
modify the color table, this will affect the colors of all applications running on 
your desktop at that time. To restore colors to all applications, click on the 
Refresh all Clients option from the PMX Command menu. 

By default, PMX determines which color visual to use by querying PM's ability to 
support the Palette Manager. If an application wants to modify color tables but 
the display driver does not support that, an error is displayed and the application 
is likely to end abnormally. 

Please see Appendix A in the X Window System Server Guide for a more 
detailed description of how PMX handles color visuals. 



11.9 Customizing X Window System Fonts 

The X Window System server uses font files to display text for X client 
applications. The OS/2 X server supplies fonts from the MIT X11R5 distribution 
as well as those from the IBM AIX product. The font files are stored in the 
\TCPIP\X11\MISC and \TCPIP\X11\75DPI directories and have an extension of 
.PCF (portable compiled font). These are the directories that PMX will search for 
fonts, unless you configure it to do otherwise. 

If you want to use fonts for an X client application that are not supplied with the 
OS/2 X Window System Server Kit but are available as source files on other 
systems, you can compile those source files to be used by PMX. Font source 
files have an extension of .BDF, and you can find them, for instance, on an IBM 
AIX system. 

Two utilities are provided to customize fonts for PMX: 
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Program Function 

BDFTOPCF Compiles a font source file (.BDF) into a portable compiled font 
(PCF). 

MKFONTDR Builds a font directory file of all the font files that it can find in an 
OS/2 directory. A font directory maps a font name to an OS/2 file 
name and is accessed by PMX to pick the right font. 

After you have compiled the source file, copy the font to a directory that PMX 
can access, and update the font directory. Now you must either run XSET fp 
rehash or restart PMX for the new path to take effect. 

If the .BDT source is not available, please contact the client vendor for .BDT files. 

Please see Appendix C in the X Window System Server Guide for a more 
detailed description of how PMX handles fonts. 
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Chapter 12. X Window System Client and OSF/Motif Kits 

The X Window System is a distributed graphical user interface (GUI) that uses 
the X protocol. The protocol is communicated between the client or application 
and an X server over a reliable bidirectional byte stream. This byte stream is 
provided by the TCP/IP communication protocol. 

In an X Window System environment, the X server distributes user input to, and 
accepts requests from, various client programs located either on the same 
system or elsewhere on the network. The X server and the X client communicate 
using the X protocol. 

in OS/2, the X Window System Client support consists of an application program 
interface (API) that creates the X program. This API lets you create an 
application that uses the TCP/IP sockets system functions to communicate with 
an X Window System Server. As an application writer, you need to be concerned 
only with the client API in writing your application. 

The communication path from the OS/2 X Window System application to the 
server involves the client code, the X Window System library, and the TCP/IP 
library. The application program that you create is the client part of a 
client-server relationship. The X server provides access to the resources that 
are shared among many X applications, such as the screen, keyboard, mouse, 
fonts, and graphics contexts. 



12.1 X Window System Client Kit 

The X Window System Client has two purposes: 

• Develop X Window applications to run on an OS/2 system. 

• Run X Window applications on an OS/2 system 

In the X Window System, the notion of client and server is somewhat reversed. 
Normally you think of yourself, or the program you are running on your PC, as a 
client, which accesses shared resources like disk storage or printers on a server 
in another location. 

However with the X Window System, the resource that you share is the display, 
which is attached to your workstation. So, your workstation must function as a 
server in order to share the display among several X Client applications. 

TCP/IP V2.0 for OS/2 is the first version of this product that includes the X 
Window System Client Kit. In previous versions, you were able to have your 
TCP/IP for OS/2 workstation function as an X Server. This meant that you could 
execute an X Client application on a remote system such as an RS/6000, and the 
presentation information was displayed on your own OS/2 workstation using X 
protocol and the X Server functions. 

The X Window System Client Kit provides you with the ability to develop X 
Window applications for the OS/2 platform and then also run them on the same 
platform. Your workstation is now equipped to function as both an X Window 
Client and Server. 
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The X Window System Client includes two parts. The X Window System Client kit 
contains the executable sample X client applications, and can be installed on 
either a FAT or an HPFS file system. The X Window System Client programmer's 
toolkit contains all the libraries, the header files, and the source files for the 
sample applications, that you need to create your own X client applications. The 
programmer's toolkit must be installed on an HPFS file system. 

Note: If you want to develop or execute an OSF/Motif application, you need the 
OSF/Motif kit. 



12.2 X Window Structure 

The X Window System Client kit includes the following layers shown in 
Figure 160. 




Figure 160. X Window Application Layers 



12.2.1 The X Library (Xlib) 

The X Window System Client Kit contains the X library (Xlib), a set of low-level 
application functions that provide access to, and control of, the display, its 
windows, and the input devices. Xlib is the fundamental layer that supports the 
intrinsics and widgets that are included in the X Window System Client Kit. 

12.2.2 The X Toolkit (Xt) Intrinsics Library 

The X Window System Client Kit contains the X toolkit library (Xt) intrinsics 
library, on the top of the X library, that allows you to simplify the design of 
applications by providing an underlying set of common user interface functions. 
Xt provides an improved approach to GUI programming. It creates a general 
mechanism for producing reusable user-interface components, and provides 
routines for creating and using user-interface components called widgets. For 
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more information on the X Toolkit Library read the X Window Client System 
Guide. 



12.2.3 The Widget Sets 

The X Window System Client Kit provides you with the Athena widget set. 

You can obtain the OSF/Motif widget set that is separately available in the 
TCP/IP for OS/2 OSF/Motif kit. 

A widget set is a collection of separate widgets. The widget is the fundamental 
data type in the X Window System Client Kit. Widgets generally provide a user 
interface component, such as scroll bar, a text-entry field, or a menu. Widgets 
are allocated dynamically and contain state information. Each widget belongs to 
a widget class that is allocated statically and initialized. The widget class 
contains the operations allowed on widgets of that class. 

12.2.4 OSF/Motif Widget Set 

You can separately order the TCP/IP for OS/2 OSF/Motif kit. It contains the 
OSF/Motif widget set, which implements user interface components, such as 
scroll bars, menus, and buttons. You can combine the OSF/Motif widget set with 
the Xt Intrinsics and Xlib to construct a Motif application. For more information 
about the OSF/Motif widget set, refer to X Window System Client Kit Guide. 



12.3 Installing X Window System Client and OSF/Motif Kit 

This chapter explains how to install X Window System Client Kit and OSF/Motif 
Kit. Before you install X Window System Client Kit, ensure that the required 
software is installed and running on the workstation. 

12.3.1 Requirements to Use X Window System Client Kit and the OSF/Motif Kit 

The X Window System Client Kit kit requires that the following be installed and 
running on the OS/2 workstation: 

• OS/2 2.x (32-bit) 

• IBM TCP/IP Version 2.x for OS/2 (or comparable software that provides the 
necessary protocol stack) 

• For development of X Window applications, the IBM TCP/IP Programmer's 
Toolkit 

• For development of X Window applications, the High Performance File 
System (HPFS) 

• To run X Window System Client Kit applications locally, the X Window 
System Server 

In addition to the above, the OSF/Motif kit requires that the X Window System 
Client Kit be installed on the OS/2 workstation. 

The following table shows the CSDs applied to our kits: 



Table 12 (Page 1 of 2). X Window System Client Kit and PMX Server applied CSDs 


TCP/IP Kft 


CSD 


X Window System Client Kit 


UN 52842 
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Table 12 (Page 2 of 2). X Window System Client Kit and PMX Server applied CSDs 


TCP/IP Kit 


CSD 


PMX Server Kit 


UN 50382 



Notes: 

1. If you want to develop X Window System Client Kit applications, install the X 
Window System Client Kit Programmer's Toolkit in an HPFS file system 

2. If you want to use the X Window System Client Kit just to enable your OS/2 
workstation to run X Window applications, you can install X Window System 
Client Kit on a File Allocation Table (FAT) file system or on an HPFS file 
system. 

The following table shows the disk space required for this kit: 



Table 13. Disk Space Requirements 


TCP/IP Kit 


Disk Space (MB) 


X Window System Client Kit 


4.0 


Motif Kit 


2.3 



12.3.2 Installing X Window System Client Kit Files 

You can install the executable sample X client programs, The X client 
programmer's toolkit, or both. However, the programmer's toolkit can be 
installed only to a disk formatted with the HPFS option. 

You can also select installation of the BookManager softcopy publications and 
the IBM Library Reader at this time. 

12.3.2.1 Installing the Executable Files 

To install only the X Window System Client Kit executable files, either to a FAT 
or to an HPFS file system, do the following: 

1. Insert the X Window System Client Kit diskette in your diskette drive 

2. At the A: prompt, enter tcpinst 

3. The TCP/IP installation window is displayed 

4. Select X-Client Runtime Services and select Install 

12.3.2.2 Installing the Programmer's Toolkit 

To install the X Window System Client Kit programmer's toolkit to an HPFS file 
system, do the following: 

1. Insert the X Window System Client Kit diskette in your diskette drive 

2. At the A: prompt, enter tcpinst 

3. The TCP/IP installation window is displayed 

4. Select X-Client Programmer's Toolkit and select Install 
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12.3.3 Installing the OSF/Motif Kit Files 

You can install the executable sample Motif programs, the Motif programmer's 
toolkit, or both. However, the programmer's toolkit can only be installed to a disk 
formatted with the HPFS option. 

12.3.3.1 Installing the Executable Files 

To install just the executable sample Motif executable files, either to a FAT or 
HPFS file system, do the following: 

1. Insert the OSF/Motif diskette in your diskette drive 

2. At the A: prompt, enter tcpinst 

3. The TCP/IP installation window is displayed 

4. Select OSF/Motif Runtime Services and select Install 

12.3.3.2 Installing the Programmer's Toolkit 

To install the OSF/Motif Programmer's toolkit to an HPFS file system, do the 
following: 

1. Insert the OSF/Motif diskette in your diskette drive 

2. At the A: prompt, enter tcpinst 

3. The TCP/IP installation window is displayed 

4. Select OSF/Motif Programmer's Toolkit and select Install 

12.3.4 Installing from a Code Server 

If you have the TCP/IP V2.0 for OS/2 base kit, you can install these kits remotely, 
from another workstation. 

These kits comply with IBM's Configuration, Installation, and Distribution (CID) 
architecture, which provides for unattended, remote installation of programs and 
applications from code servers to client workstations. 

For information about how to install these kits from a code server to a client 
workstation, see the TCP/IP V2.0 for OS/2: Installation and Administration manual. 



12.4 Running X Window Client Applications 

There are several sample OS/2 X Window applications provided with the X 
Window Client. In this section, we describe how to setup an environment to run 
these applications: 

1. Start the X Window System Server from the TCP/IP folder on your OS/2 
desktop. This provides access to the resources that are shared among many 
X applications, such as the: 

• Screen 

• Keyboard 

• Mouse 

• Fonts 

• Graphics contexts 

2. Ensure that you have set your display environment variables. Whenever you 
start an X Window application, it will look up the variable DISPLAY in your 
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OS/2 system environment. You can set this variable in the Configuration 
Notebook or from an OS/2 command prompt with this command: 

SET DISPLAY=9.67.38. 106:0 

Where 9.67.38.106 is our IP address and 0 is the screen on which we want to 
display the information. 

3. Many of the commonly used X Window functions are stored in dynamic link 
libraries which are called by X Window applications at runtime. These 
dynamic link libraries are normally copied to your TCPIP\DLL directory at 
installation. The files that contain the dynamic link libraries are: 

• Xaw.dll 

• oldX.dll 

• Xext.dll 

• Xmu.dll 

• Xlib.dll 

• Xt.dll 

Please ensure that these files are on your system. 

4. This is a list of the sample X client executable programs provided in the X 
Window System Client Kit. 

Xant.exe A 3270 terminal Emulator program 

Xcalc.exe Calculator 

Xclock.exe Clock 

Xeyes.exe Eyes that watch your mouse pointer 

Xlogo.exe Displays the X logo 

You can start any of these applications from an OS/2 command prompt. For 
example to start the calculator, use this command: 

Xcalc.exe 

Figure 161 shows the calculator program running on the Workplace Shell: 




Figure 161. Xcalc (OS/2 X Window Client Application) 

If you have access to a S/390 processor running TCP/IP for MVS or VM, then 
you should try running the X Window 3270 emulator supplied with X Window 
System Client Kit. Use this command to start the emulator: 

Xant 9.67.38.65 

Where 9.67.38.65 is the address of the S/390 processor. 
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Figure 162 on page 219 shows the graphics capabilities of the Xant 3270 
terminal emulator: 




Figure 162. Xant (OS/2 X Window Client Application) 

You may find that when you run an X Client application that the colors change on 
your desktop. This is a known problem and there is a fix being developed. In the 
meantime, you can overcome this problem by switching to an OS/2 Full Screen, 
and then back to your desktop. Your desktop will be restored to its natural 
colors. 



12.5 Running an OSF/Motif Application 

When you install the OSF/Motif kit, an application called xmpiano comes as a 
sample application developed using the OSF/Motif widget. To run this application 
you need to have the X Window System Client Kit installed at your workstation. 

12.5.1 Running Xmpiano 

Before starting the xmpiano application, be sure that: 

1. The X Window System Server is started. If it is not, you just need to double 
click on the PMX Server icon located in the TCP/IP folder on your OS/2 
desktop. 

2. Ensure that you have set your display environment variable. Whenever you 
start an X Window or OSF/Motif application, the environment variable 
DISPLAY is searched. You can set this variable in the Configuration 
Notebook or from an OS/2 command prompt with the following command: 
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set display =9.67.38.70:0 

Where 9.67.38.70 is the IP address of the X Window System Server machine and 
0 is the screen on which you want to display the application's information. 

Now you have to execute the xmpiano application. On an OS/2 command prompt 
type xmpiano and enter. You should see the following window at the X Window 
System Server screen: 




Figure 163. OSF/Motif Application Xmpiano 



12.5.2 X Window Manager 

There is no X Window manager. Presentation Manager and PMX (X Server) 
handle many of the functions performed by an X Window manager like the Motif 
window manager. 

In the figure below, you can see the OS/2 desktop. The applications running 
were written using either the Athena or OSF/Motif widget, and they are sharing 
the services of the same X Window System Server and using the Presentation 
Manager as the windows manager. 
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Figure 164. OS/2 Desktop Athena and OSF/Motif Widget Applications 



12.5.3 Root Window Limitations 

Drawing on the root window is prohibited in OS/2. The root window for an X 
Window application in an OS/2 environment is the OS/2 desktop. If an X Window 
Client tries to draw on the root window of an OS/2 workstation, then nothing will 
happen and no error messages will be reported. 

12.5.4 Application Resource File 

Many properties of an X Window application can be set at runtime. These 
properties include: 

• Colors 

• Fonts 

• Window sizes 

These properties are usually stored in an Application Resource File. On an OS/2 
workstation this file is: 



\\TCPIP\ETC\XDEFAULT 

You can also use an application-specific resource file on an OS/2 workstation. 
The name of this file is set in the XENVIRONMENT variable. For example, if you 
wanted to use a special resource file for the Xclock application and the 
information was stored in the file C:\TCPIP\ETC\XCLOCK.AD, then you would 
include this command in your CONFIG.SYS or execute it from a command 
prompt: 
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SET XENVI RONMENT=C ; \TCPI P\ETC\XCLOCK . AD 



or: 

xrdb -load xclock.ad 

If you fail to use an Application Resource File, you may experience strange 
behavior from some of your X Window applications such as extremely large or 
peculiar fonts. This is caused by some poor guesses by the application in the 
absence of information normally provided from the application resource file. 

There are several utilities provided to manipulate information in the application 
resource file. Listed below is a description of each of these utilities. 

Utility Description 

XRDB X Client application to get or set values in the Application Resource 
File. 

APPRES Lists the resources that currently might apply to a client. 

EDITRES Displays a tree that shows the full hierarchy of any X Toolkit client 
that uses the EDITRES protocol and lets you modify the client's 
resource specifications. 

LISTRES Lists the resource database for one or more specified widgets. 

VIEWRES Displays the hierarchy of the widget set. You can expand each node in 
the display to see the resources associated with the node. 

12.6 Development of X Window Client and OSF/Motif Applications 

X Window System Client Kit provides a set of application programming interfaces 
that enable you to create an X Window program which will use the X protocol to 
send and receive information to and from an X Server for presentation on a 
screen. The X program communicates to an X Server using sockets. 

The X Window System Client Kit provides these components for development of 
an X Client application for OS/2: 

Component Subdirectory 

Library files \LIB 

Sample Source Code \SAMPLES\X11 

X Header Files \INCLUDE\X1 1 

X Bitmap Files \INCLUDE\X11\BITMAPS 



The Import Library files consist of: 


File 


Description 


Xlibi.llb 


X 


XtLIib 


X Intrinsics 


Xexti.lib 


X extensions 


Xmui.lib 


X Miscellaneous Utilities 


oldXi.lib 


X10 compatibility routines 


Xawi.lib 


X Athena Widgets 
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The X Window System Client Kit requires that the following be installed and 
running on the OS/2 workstation for application development: 

• TCP/IP Programming Kit 

• High Performance File System (HPFS) 

• A C-32bit compiler (for instance the IBM CSET + +) 

If you intend to develop OSF/Motif applications, you need the OSF/Motif kit, 
which includes: 

• Motif library (Xm) 

• Motif header files 

• Motif resource manager library (Mrm) 

• Motif resource manager header library 

• A proof of licence 

For more information on how to develop X Window System Client Kit and 
OSF/Motif applications, refer to X Window System Client Guide manual. 

12.6.1 Tips for Porting Applications from UNIX 

When porting an application from a UNIX system to an OS/2 system, you should 
consider these important recommendations: 

1. The C Set/2 /sm switch is often needed to get the maximum migration 
allowances for constructs often found in UNIX C code. 

2. The /ms switch is needed to ensure system linkage for all calls. When you 
use this switch, you must explicitly include header files. Many UNIX 
applications do not include these header files. Without them, the application 
will exit abnormally under OS/2 stating exception in C library routine. 

3. Extensive use of signals must be avoided or rewritten. 

4. Some UNIX system calls like pipe and fork have no OS/2 equivalent. Try to 
simply avoid these applications and run the application in one process. If 
that is not possible, the application will likely need significant modification to 
run under OS/2. 

5. Makefiles must be written to be compatible with NMAKE under OS/2. Refer 
to the samples directory provided with the X Client product to see an 
example of an NMAKE compatible makefile for X Window applications. 
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Chapter 13. DOS/Windows Access Interface 



The DOS/Windows Access Kit consists of: 

• A virtual device driver 

• A set of TCP/IP Version 2.1 for DOS dynamic link libraries 

• A set of TCP/IP Version 2.1 for DOS programs 

The virtual device driver provides access to TCP/IP protocol stacks running 
under OS/2, and the dynamic link libraries (DLL) contain functions to access the 
virtual device driver. The DOS programs use functions in the DLLs to send and 
receive information to the TCP/IP protocol stack. 




Figure 165. DOS/Windows Access Kit Protocol Stack 

When installed, this kit enables you to run your applications from: 

• DOS (VDM) session 

• WIN/OS2 session 

The virtual device driver and dynamic link libraries have been developed to 
support any DOS or Windows application which has been developed using these 
TCP/IP Version 2.1 for DOS application programming interfaces: 

Library Description 

SOCKETS.LIB Real mode small model sockets library 

SOCKETL.LIB Real mode large model sockets library 
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RPCS.LIB 
RPCL.LIB 
FTP API. LIB 
WINSOCK.LIB 
WFTPAPI.LIB 
BIOS int14h 



SUN RPC small model library 

SUN RPC large model library 

FTP Application Programming Interface library 

Windows Sockets API VI. 1 library 

Windows FTP Application Programming Interface library 

BIOS Interrupt 14 Telnet Redirector 



We used and tested two applications which meet these specifications: 

• IBM TCP/IP V2.1 for DOS 

• Hummingbird HCL-eXceed/W V3.3.2 



13.1 Configuration 

When you install the DOS/Windows Access Kit kit, several modifications are 
made to your system set up that you may not notice: 

• DOS Settings 

• AUTOEXEC.BAT 

• Directory Structure 

• ETC Environment Variable 

• Name Resolution 

13.1.1 DOS Settings 

During installation, the settings of DOS and WIN/OS2 objects on your system are 
modified to include this device statement: 

D0S_DEV ICE C:\TCPI P\BI N\V00STCP. SYS 

13.1.2 AUTOEXEC.BAT 

During installation, your AUTOEXEC.BAT will be modified to include: 

• C:\TCPIP\DOS\BIN in your path statement 

• SET ETC = C:\TCPIP\DOS\ETC 

13.1.3 Directory Structure 

During installation, a seperate directory structure is set up for the DOS/Windows 
Access Kit kit. 

\TCPIP\DOS\ETC\ Configuration and Name Resolution Files 
\TCPIP\DOS\BIN\ Programs and DLL's 

13.1.4 ETC Environment Variable 

Both OS/2 and DOS TCP/IP applications use the ETC environment variable to 
find the path to the TCP/IP configuration and name resolution files. The OS/2 
TCP/IP installation program initializes the ETC variable by creating an entry like 
this in CONFIG.SYS, on the boot drive: 

SET ETC=<path>\ETC 

The DOS/Windows Access Kit initializes the ETC variable by creating an entry 
like this in in the AUTOEXEC.BAT file on your boot drive: 
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SET ETO<path>\DOS\ETC 

The two different directories are used because some of these files have different 
formats in OS/2 and DOS systems. 

When you install the DOS/Windows Access Kit, the following files are stored in 
the < path > \DOS\ETC directory. 



File 

RESOLV 

HOSTS 

SERVICES 

PROTOCOL 



Description 

Domain Name Server name resolution 
HOSTS file name resolution 
Service name to port number mapping 
Protocol name to protocol ID mapping 



13.1.4.1 Name Resolution 

The DOS TCP/IP programming interfaces use name resolution files like those 
used by OS/2 TCP/IP. These files are: 

File Description 

RESOLV Domain Name Server name resolution 
HOSTS HOSTS file name resolution 



When you install the DOS/Windows Access Kit, the installation program sets the 
ETC environment variable (in the AUTOEXEC.BAT file on the boot drive) to the 
directory that contains the name resolution files. This is usually the 
< path > \DOS\ETC subdirectory. If you change the ETC path in AUTOEXEC.BAT, 
or if you would like to use a HOSTS file, you must update one or both of the 
RESOLV and HOSTS files pointed to by the ETC path in AUTOEXEC.BAT. In most 
cases, you can just copy the corresponding files from the ETC path specified in 
CONFIG.SYS to the ETC path specified in AUTOEXEC.BAT. 

If you do NOT modify the ETC environment variable in AUTOEXEC.BAT (to point 
to a path other than the path set during installation), the configuration notebook 
(TCPIPCFG) will update the RESOLV file when you change the configuration 
notebook pages that correspond to the RESOLV file. The configuration program 
does this by copying the RESOLV file from the ETC path specified in CONFIG.SYS 
to the ETC path specified in AUTOEXEC.BAT after it makes any changes. 



13.2 Using DOS/Windows Access Kit 

This section describes how to use DOS and Windows TCP/IP applications under 
OS/2 with TCP/IP V2.0 for OS/2 and the DOS/Windows Access Kit. 

13.2.1 DOS Programs supplied with TCP/IP V2.0 for OS/2 

PING is the only DOS TCP/IP program supplied with the DOS/Windows Access 
Kit, you can run this from a DOS window: 
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r 



Virtual TCP/IP Version 2.1 for DOS 
Copyright (c) IBM Corp. 1992, 1993 



Version: 2. 1.0. 3 



C:\>ping rs60007 10 1 

PING rs60007.itsc.ra1eigh.ibm.com (9.67.38.75): 56 data bytes 
64 bytes from 9.67.38.75: icmp_seq=0 ttl=255 time=30 ms 
64 bytes from 9.67.38.75: icmp_seq=l ttl=255 time=30 ms 
64 bytes from 9.67.38.75: icmp_seq=2 ttl =255 time=0 ms 

64 bytes from 9.67.38.75: icmp_seq=3 ttl =255 time=30 ms 

64 bytes from 9.67.38.75: icmp_seq=4 ttl =255 time=30 ms 

64 bytes from 9.67.38.75: icmp_seq=5 ttl =255 time=30 ms 



— - rs60007.itsc.raleigh.ibm.com ping statistics — 

6 packets transmitted, 6 packets received, 0% packet loss 
round-trip min/avg/max = 0/25/5080 ms 



Please notice that the virtual TCP/IP Version 2.1 for DOS device driver has been 
loaded. 

13.2.2 TCP/IP Version 2.1 for DOS 

TCP/IP Version 2.1 for DOS can be installed on a system already using TCP/IP 
V2.0 for OS/2. This will allow you to run many of the DOS and Windows 
applications provided with TCP/IP Version 2.1 for DOS in DOS and WIN/OS2 
sessions of OS/2. Some examples of these applications are: 

WTELNET.EXE 

TELNET.EXE 

Although these applications will work with the DOS/Windows Access Kit, this is 
not the primary purpose of the DOS/Windows Access Kit, as most of these 
applications are provided with TCP/IP V2.0 for OS/2 in OS/2 versions. The main 
purpose of the DOS/Windows Access Kit kit is to allow you to run other DOS and 
Windows applications which are not already available for OS/2. 

You should note that the entire protocol stack and application programming 
interfaces provided with TCP/IP Version 2.1 for DOS should not be used with a 
machine already equipped with TCP/IP V2.0 for OS/2 and the DOS/Windows 
Access Kit, which provides the same functions through virtual device drivers and 
a set of its own dynamic link libraries. 

13.2.2.1 TCP/IP for DOS Configuration for DOS 5.01 

We have included this configuration so that you can see the differences between 
the configurations required for the DOS and TCP/IP V2.0 for OS/2 environments. 
Listed below is the configuration information for a machine running TCP/IP V2.1 
for DOS configuration on DOS 5.01. 

CO NFIG.SYS 
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shell “c:\dos\command. com /e:2600 /p 
files 0 50 

DEVICE=C:\DOS\SETVER.EXE 
DEV I CE=C : \WI NDOWS\HIMEM. SYS 
DOS=HIGH 

COUNTRY=001, .C:\DOS\COUNTRY.SYS 

DEV ICE=C : \WI NDOWS\SMARTDRV . EXE /DOUBLEJUFFER 

DEVICE = C:\TCPDOS\BIN\PROTMAN.DOS /I: C:\TCPDOS\ETC 

DEVICE = C:\TCPDOS\BIN\DOSTCP.SYS 

DEVICE = C:\TCPDOS\BIN\IBMTOK.DOS 

STACKS=9,256 

devi ce=c:\dos\ansi .sys 

lastdri ve=z 

AUTOEXEC.BAT 

@echo off 

c:\tcpdos\bin\NETBIND 

C:\WINDOWS\SMARTDRV.EXE 

SET ETC=C:\TCPDOS\ETC 

SET COMSPEC=C:\DOS\COMMAND. COM 

SET TCPBASE=C:\TCPDOS 

0ECHO OFF 

PROMPT $P$G 

PATH C:\DOSLANiC:\WINDOWSiC:\DOS;C:\TCPDOS\BINiC:\UTIL;C:\CMD; 

SET TEMP=C:\DOS 

KEYB US,, C:\DOS\KEYBOARD. SYS 

doskey /reinstall 

CALL TCPSTART 

9ECHO OFF 

YNPROMPT Y N 30 Start DOS LAN Requester (Y/N)? 

IF ERRORLEVEL 1 GOTO NODLR 
NET START 

IF ERRORLEVEL 1 GOTO NODLR 
CALL INITFSI.BAT 
: NODLR 

TCPSTART.BAT 



=- TCPSTART batch file 

=- begins by determining that the necessary environment variables are set -= 



@echo off 

IF %ETC%.=. GOTO ETCHELP 
INETCHK 

IF ERRORLEVEL 1 GOTO INET_DOWN 
GOTO I NET UP 



:INET_DOWN 




s=- install the Protocol Stack 





IF %INET%.=. inet 

IF NOT %INET%.=. inet -d %INET% 

if errorlevel 1 GOTO done 



=- Assign our IP address and set NETMASK and default ROUTE 



route -f 
arp -da 
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REM slipdial 

ifconfig nd0 9.67.38.68 netmask 255.255.255.192 broadcast 9.67.38.127 up 
route add -hopcount 1 -mtu 1496 default 9.67.38.65 
PING -cl 9.67.38.65>nul 
REM ftpd -b 

REM if errorlevel 0 echo FTP Daemon Started 

REM lpd -b -c 

REM if errorlevel 0 echo LP Daemon Started 

nbtcp 

if errorlevel 0 echo netBIOS Started 

REM routed 

REM if errorlevel 0 echo ROUTED Started 

echo. 

echo TCP/IP is enabled. 



:=- — — 

REM USER CUSTOMIZATION SECTION 
REM 

REM WARNING: Do not remove the lines, 'REM Begin_User_Customization' 
REM and 'REM End_User_Customization' because these are used 

REM to protect any user-added commands from being deleted by 

REM the CUSTOM program 

REM 

REM Begin_User_Customization 
REM End_User_Customization 
goto DONE 



I NET UP 

ECHO TCP/IP is already up! 
goto DONE 




=- Provide any needed HELP 





:ETCHELP 

ECHO You MUST set the* l;33;40m ETC ^0537; 40m variable 
ECHO before attempting to start TCPPLUS 
: DONE 



13.2.2.2 TCP/IP for DOS Configuration with DOS/WIndows Access 
Kit 

You will notice that there is very little set up required to run DOS or Windows 
applications after you have installed the DOS/Windows Access Kit. You should 
not load any TCP/IP for DOS protocol support. Here are examples of 
configurations: 

CONFIG.SYS: You should ensure that this device driver is included in the 
DEVICE area of your DOS Settings: 

DOS_DEVICE C:\TCPI P\BI N\VD0STCP . SYS 

AUTOEXEC.BAT: You should ensure that your AUTOEXEC.BAT has the 
necessary path information to your TCP/IP Version 2.1 for DOS applications. 

@ECH0 OFF 
ECHO. 

PROMPT $i$p$g 

REM SET DELDIR=C:\DELETE,512; 

PATH=C:\0S2;C:\0S2\MD0S;C:\0S2\MD0S\WIN0S2;C:\;C:\TCPIP\D0S\BIN;C:\TCPD0S\BIN 
LOADHIGH APPEND C:\0S2;C:\0S2\SYSTEM 
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SET TMP=C:\ 

REM LOADHIGH DOSKEY FINDFILE=DIR /A /S /B $* 

REM DOSKEY ED I T=QBAS I C/ED I TOR $* 

REM SET DIRCMD=/A 

SET T EMP=C : \0S2\MD0S\WI N0S2\TEMP 

SET ETC=C:\TCPIP\DOS\ETC 

TCPSTART.BAT: You do not need to execute this batch file. These functions are 
provided by TCP/IP V2.0 for OS/2. 

13.2.2.3 Restrictions 

Although the DOS/Windows Access Kit supports all of the documented TCP/IP 
Version 2.1 for DOS APIs, there are some applications, shipped with TCP/IP 
Version 2.1 for DOS, that are not supported by the DOS/Windows Access Kit 
because they manage the DOS TCP/IP protocol stack (INET). Because the 
DOS/Windows Access Kit lets you run on the OS/2 TCP/IP stack, there is no DOS 
stack to manage. The following table lists DOS TCP/IP applications that are not 
supported in a VDM, and the corresponding (suggested) OS/2 TCP/IP 
applications: 



Table 14. Restrictions 


DOS Application 


OS/2 Application 


Description 


ifconfig 


ifconfig 


Used to manage network interfaces 


arp 


arp 


Used to manage ARP table entries. 


netstat 


netstat 


Used to query internal structures 


route 


route 


Used to manage static routes 


routed 


routed 


RIP support 


snmpd 


snmpd 


SNMP Agent support 


inet -d < fig > 


vdebug < fig > 


Internal protocol stack tracing 



13.2.3 HCL-eXceed/W 

We installed HCL-eXceed/W V3.3.2 on a system with these software packages 
already installed: 

• DOS/Windows Access Kit 

• TCP/IP V2.0 for OS/2 

• Operating System/2 

HCL-eXceed/W provides a suite of TCP/IP applications such as: 

• Telnet 

• FTP 

• PING 

It also provides X Client and X Server functions, so that you can run X Windows 
applications in a WIN/OS2 session. It does not provide any transport layer 
functions. HCL-eXceed/W supports several products as transports, for example: 

• IBM TCP/IP for DOS 

• Novell LAN Workplace for DOS 



Chapter 13. DOS/Windows 231 






























Microsoft DOS TCP/IP 



Normally, you need to install one of these products to provide the transport layer 
functions to HCL-eXceed. However with our set up, the transport layer is 
provided by TCP/IP V2.0 for OS/2 and DOS/Windows Access Kit. You should set 
up your CONFIG.SYS and AUTOEXEC.BAT as shown in 13.2.2, “TCP/IP Version 
2.1 for DOS" on page 228. 

During the installation process of HCL-eXceed/W, you should select IBM TCP/IP 
for DOS as your TCP/IP software. You should also ensure that XPORT.dll and 
WINSOCK.DLL are included in your DOS SEARCH PATH before you start 
WIN/OS2. 



We were able to use HCL-eXceed/W as a full screen WIN/OS2 session, and also 
seamlessly. These are the steps that we had to perform in order to use 
HCL-eXceed/W seamlessly: 



1 . 



2 . 

3. 

4. 

5. 



Create a program called Program Manager on your OS/2 desktop with these 
properties: 

Parameter Value 

Path and file name PROGMAN.EXE 

Working Directory C:\OS2\MDOS\WINOS2 

Session WIN-OS2 window 

Start the Program Manager from your OS/2 desktop. 

Select Window from the action bar of the Program Manager. 

Select eXceedW from the pull-down menu. 

Double click on the object eXceed/W in your Program Manager. This will 
start the X server. 



6. Double click on the object Telnet in your Program Manager. 

7. Type in the name of the host on which you would like to establish this Telnet 
session. 



8. Once the Telnet session is established you must type in your user ID and 
password. 

9. You will see the greeting messages from the host on the Telnet session. We 
connected to a RS/6000 running AIX with an address of 9.67.38.75. 

10. We started an X Windows terminal session by running this command: 

aixterm -d 9.67.38.186:0 & 

11. Select the X Windows terminal session on your desktop. 

12. We started the X Windows application InfoExplorer by running this command: 

info & 

13. The Info Explorer application starts and your panel should look similar to 
Figure 166 on page 233. 
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Figure 166. HCL-eXceed/W Example 

14. We have just created several sessions in the preceding steps, all of which 
are WIN/0S2 sessions. You can check this by examining your OS/2 task list. 



In the example described above, we only used the X Server functions of 
HCL-eXceed. But you can also use HCL-eXceed/W as an X Client. 



13.3 Summary 

The following tables show which types of TCP/IP applications you can use with 
the DOS/Windows Access Kit: 



Table 15 (Page 1 of 2). Summary of TCP/IP Functions Available in DOS, Windows and OS/2 


OS/2 TCP/IP Client 


DOS Applications Installed using DOS/Windows Access Kit 


None 


IBM TCP/IP V2.1 
for DOS 


HCL-eXceed 


Telnet 


O 


ODW 


OW 


PM-ANT.TN3270 


O 






FINGER 


0 


OD 


o 


TALK 


0 


OD 


o 


FTP 


0 


ODW 


OW 


TFTP 


0 


OD 




LPR/LPRMON 


o 


OD 


0 


REXEC 


o 


OD 


OW 


RSH 


o 


OD 


OW 
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Chapter 14. NetBIOS Interface 



This chapter gives an overview of the functions of the NetBIOS protocol and 
describes how to transport NetBIOS traffic across a TCP/IP network using the 
NetBIOS Kit of the TCP/IP V2.0 for OS/2 product. 



14.1 The NetBIOS Protocol 

NetBIOS provides a method for communications between computers on a local 
area network. 

Most of today's IBM LAN-based applications use the NetBIOS services to 
communicate over a token-ring or Ethernet network. Examples are IBM OS/2 
LAN Server V3.0, IBM Extended Services/2 V1.0, IBM Communications 
Manager/2 VI. 0, IBM Database 2 for OS/2, as well as many customer-developed 
applications that use the NetBIOS application programming interface, such as 
Lotus Notes. 

Roughly, NetBIOS provides four kinds of services: 

1. Name management services. It provides support for: 

• Name registration: Verifies that a NetBIOS name is not already being 
used on the network. 

• Name defense: Makes sure that once a name is registered, no other 
node uses the name. 

• Name search: Finds the network address of a node known by a NetBIOS 
name only. 

2. Session services. A session is a connection-oriented service used for 
reliable data transfer. It has three phases: 

• Session establishment: It is during this phase that the IP address and 
TCP port of the called name are determined, and a TCP connection is 
established with the remote party. 

• Steady state: Once the connection (session) is established, simple Send 
and Recei ve verbs are provided for data transfer. 

• Session close: The session is closed whenever either a party (in the 
session) closes the session or it is determined that one of the parties 
has gone down. 

3. Datagram services. Connectionless services are available through the use 
of monocast, multicast and broadcast messages. They are used to support 
low overhead communications with minimal error checking. NetBIOS 
datagrams are carried within UDP packets. 

4. Miscellaneous services. They are used to handle unusual situations such as 
errors. 

Both session and datagram services use the logical network names to address 
recipients. 

NetBIOS has, however, limitations that do not suit a given communications 
environment under certain circumstances: 

1. The NetBIOS protocol can only be used on a LAN 

2. The NetBIOS protocol cannot be routed 
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3. The NetBIOS protocol uses single route broadcasts to establish connections. 

A solution to overcome these limitations can be found in RFC 1001 and RFC 
1002. They describe the standard to implement the IBM NetBIOS services (as 
described in the IBM LAN Technical Reference ) on top of the TCP and UDP 
protocol layers. 



14.2 NetBIOS over TCP/IP 

The TCP/IP V2.0 for OS/2 NetBIOS Kit (TCP/NetBIOS) was previously available as 
the IBM NetBIOS Version 1 for TCP/IP for OS/2 product. It enables NetBIOS 
applications running on OS/2 workstations with IBM TCP/IP to communicate, 
over a TCP/IP network, with other OS/2 workstations with TCP/IP and 
TCP/NetBIOS, or other vendor platforms running equivalent RFC 1001 and RFC 
1002 compliant TCP/IP support. 

TCP/NetBIOS does not communicate with native NetBIOS nodes but users who 
presently have native NetBIOS networks can operate TCP/NetBIOS networks 
concurrently on the same local area network. 

Note: The two NetBIOS networks will be independent and will not communicate 
with each other. No routing or bridging can be established between 
native NetBIOS and TCP/NetBIOS. 



TCP/NetBIOS is compatible with both IBM's NetBIOS and Microsoft's NetBIOS 
specifications. 



TCP/NetBIOS can be used with any adapter supported by TCP/IP V2.0 for OS/2. 

It replaces the NetBIOS support provided with Network Transport Services/2, IBM 
Extended Services/2 VI. 0, or IBM OS/2 LAN Server V2.0. NetBIOS application 
programs remain unchanged, but will now communicate over TCP/IP instead of 
directly over a LAN. 



TCP/NetBIOS is a TCP/IP application but application programs that interface with 
TCP/NetBIOS for communications are not TCP/IP applications because they do 
not interface directly with TCP/IP (but with NetBIOS). 



TELNET 




FTP 




SMTP 



NetBIOS 

Appls 



TCP/NetBIOS 



A A 

T v 



TFTP 

♦ 



t 




Two levels of OS/2 interfaces exist for the NetBIOS protocol. An application 
program can use a Dynamic Link Routine interface, or a Device Driver interface. 
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Figure 168. NetBIOS Version 1 for TCP/IP for OS/2 

The RFCs define three modes of operations: 

1. Broadcast or B-node: 

This mode uses broadcast to identify the target node and then establish 
point-to-point communications between B-nodes. This is the most commonly 
implemented mode. This covers TCP/IP implemented in environments which 
support broadcast, LANs in particular. 

2. Point-to-Point or P-node: 

This mode requires the use of a NetBIOS Nameserver and a NetBIOS 
Datagram Distribution server. These servers are complex and difficult to 
implement. P-nodes operate in an environment where there are no 
broadcasts, only point-to-point connections. 

3. Mixed mode or M-node: 

M-nodes are the same as P-nodes but with the ability to perform broadcasts. 



TCP/NetBIOS provides the basic NetBIOS services required for B-nodes and 
some P-node extensions. This allows TCP/NetBIOS to operate through routers 
and to use TCP/IP domain name servers. The extensions do not alter the 
protocol as seen by a B-node. The extensions are implemented by two 
additional files (the BROADCAST file and the NAME file) and the use of the 
Domain Scope String. 
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Because of the possibility of operating NetBIOS over a very large and dispersed 
TCP/IP network, and because NetBIOS names are to be unique, the RFCs specify 
an expanded form of NetBIOS name. This addition is called the NetBIOS Name 
Scope, because it has the effect of limiting the scope of a NetBIOS name. This 
surname is hidden from the casual user. The idea is that two RFC-compliant 
NetBIOS nodes can communicate only if they have the same NetBIOS Name 
Scope. For example, a NetBIOS name ERNIE may have a scope HQ. The name 
transmitted on the network will contain both parts of the name, as ERNIE.HQ. 

When an application requests NetBIOS to locate a host, that is, to find the TCP/IP 
address of the NetBIOS name, it uses three algorithms: 

1. The first is a NetBIOS broadcast. It will look for the node using both the 
TCP/IP broadcast address, which will result in a broadcast to the local 
nodes, and the addresses found in the BROADCAST file. The node that has 
the requested name will send a positive response to the originating host. 
When a positive response is received, communication can begin. If the 
broadcast is unsuccessful, then the next algorithm will be invoked. 

2. The second is the use of the NAME file. The NetBIOS name is matched 
against the name file. If a match is found, TCP/NetBIOS will use the 
corresponding TCP/IP address to communicate directly with the remote host. 
If the name is not found, then the next algorithm will be invoked. 

3. The third is the use of the Domain Scope string. TCP/IP NetBIOS will encode 
the NetBIOS name into the domain name format and query the TCP/IP name 
server or the local host table. 

Finally, if a match is still not found, the program generates an error message. 



14.3 Installation of TCP/NetBIOS 

To install TCP/NetBIOS, insert the NetBIOS Kit diskette into a diskette drive on 
your workstation, for instance drive A:, make A: the current directory, and enter: 

A:\INSTALL 

The installation program will ask you for the name of the directory where you 
want to install TCP/NetBIOS. 

Note: You must enter a directory name here; there is no default. Installation 
will, however, create the specified directory if it does not already exists. 

The next things you need to tell the installation program are: 

1. Your IP address 

2. The IP broadcast address of your network. 

Note: Be careful with broadcast addresses, especially when you are using 
subnets. TCP/NetBIOS will not automatically calculate the broadcast 
address from a given subnet mask as does TCP/IP V2.0 for OS/2. You 
will therefore have to obtain your broadcast address from your 
network administrator or use the 

ifconfig lanO 

to get the broadcast address. Specifying a wrong broadcast address 
will result in failure to establish NetBIOS communications over 
TCP/IP. 
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The following screen shows the installation procedure of the NetBIOS Kit (it runs 
full-screen!): 



/ 




N 


[A:\]instal1 
NetBIOS/2 installation 






Enter the installation directory (e.g. f C:\NETBI0S2) : C:\NETBI0S2 




Copying files ... 
A:\NBTCP.EXE 


~> C:\NETBI0S2\NBTCP.EXE 




A:\NBDRIVER.SYS 


~> C:\NETBI0S2\NBDRIVER.SYS 




A:\ACSNETB.DLL 


~> C:\NETBI0S2\ACSNETB.DLL 




A:\ACS.LIB 


— > C:\NETBI0S2\ACS.LIB 




A:\MAPNAME.EXE 


~> C:\NETBI0S2\MAPNAME.EXE 




A:\MAPNAME.C 


— > C:\NETBI0S2\MAPNAME.C 




Enter your IP address: 


9.67.38.81 




Enter the IP broadcast: 


9.67.38.127 




A sample CONFIG.SYS will 


be created. 




Please COPY C:\NETBI0S2\C0NFIG.SYS to C:\CONFIG.SYS after checking it. 




A sample STARTUP.CMD will be created. 

Please COPY Cj\NETBI 0S2\STARTUP.CMD to C:\STARTUP.CMD after checking it. 




Installation complete. 






[A:\] 






V 




-/ 



Figure 169. NetBIOS for TCP/IP Installation 

Since TCP/NetBIOS replaces both the device driver and the dynamic link 
interfaces of native NetBIOS, it is required to make changes to your CONFIG.SYS 
file. 

The following table shows which files need to be changed to switch from native 
NetBIOS to TCP/NetBIOS: 



Table 17. Native NetBIOS and TCPINetBIOS Interfaces 


Interface 


Native NetBIOS 


TCP/NetBIOS 


Device Driver 


\IBMCOM\PROTOCOL\NETBIOS.OS2 


\NETBIOS2\NBDRIVER.SYS 


Dynamic Link 


\IBMCOM\DLL\ACSNETB.DLL 


\NETBIOS2\ACSNETB.DLL 



Since TCP/NetBIOS requires the TCP/IP protocol stack to be initialized before it 
starts, and since it requires itself to be started before any other NetBIOS 
application, it needs to make changes to your STARTUP.CMD file as well. 

Note: The installation program will make a copy of your current CONFIG.SYS 
and STARTUP.CMD files in the \NETBIOS2 directory as shown in the 
screen above. It will make all changes to these files that it thinks are 
necessary. However, it does not do that properly, so it is a must that you 
look at these files before copying them back to the root directory of your 
OS/2 boot drive! 

The following changes are made by the TCP/NetBIOS installation program: 
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CONFIG.SYS 



REM * 

REM * 

REM * Old LIBPATH= statement was: 

REM LIBPATH=C:\IBMCOM\DLL; ... 

REM * 

REM * New LIBPATH= statement is: 
LIBPATH=C:\NETBI0S2;C:\IBMC0M\DLL; . . . 
REM * 

REM * 



REM * 

REM * 

REM * No Old NetBIOS device statement found 
REM * 

REM * New NetBIOS device statement is: 
DEVICE=C:\NETBI0S2\NBDRIVER.SYS 
REM * 

REM * 



STARTUP.CMD 



REM * 

REM * 

REM Un comment the following line to start NetBIOS/2 
REM START “NetBIOS/2" C:\NETBI0S2\NBTCP ip addr ip_bcast 
REM * 

REM * 



Looking at the CONFIG.SYS changes, the first one regarding the LIBPATH 
statement is okay. When an application looks for a Dynamic Link Library (DLL), 
it searches that statement and loads a DLL from the first directory where it can 
be found. Just make sure that \NETBIOS2 is always ahead of \IBMCOM\DLL in 
order to load the proper ACSNETB.DLL file which comprises the DLL interface 
for NetBIOS applications. 

In the second statement, saying that no old NetBIOS driver statement could be 
found is definitely wrong if you already have LAN Adapter and Protocol Support 
(LAPS) installed (for instance with IBM OS/2 LAN Server V3.0 or with IBM 
Communications Manager/2 VI. 0). The installation is only looking for the OS/2 
Extended Edition NetBIOS interface device driver (NETBDD.SYS), not for the one 
that comes with LAPS (NETBIOS.OS2). The new statement with NBDRIVER.SYS, 
however, is correct and required for TCP/NetBIOS to operate properly. 

To replace the NetBIOS device driver interface of LAPS with that of 
TCP/NetBIOS, erase the lines with the following statements: 

DEVICE=C: \IBMC0M\PR0T0C0L\NETBEUI . 0S2 
DEVICE=C:\IBMC0M\PR0T0C0L\NETBI0S.0S2 
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You may still keep them for later purposes, but they should then be commented 
out: 

rem DEVICE=C:\IBMC0M\PR0T0C0L\NETBEUI.0S2 
rem DEVICE=C:\IBMC0M\PR0T0C0L\NETBI0S.0S2 

If you only have the version of LAPS installed that comes with TCP/IP V2.0 for 
OS/2, you do not have any NetBIOS support configured so far. TCP/NetBIOS will 
then provide you with the possibility to also run NetBIOS applications that do not 
have their own device drivers. 

Looking at the STARTUP.CMD file, all that TCP/NetBIOS installation does is to 
insert a statement for itself to be loaded. It does not check whether TCP/IP V2.0 
for OS/2 is started, so you have to make sure it is. 

TCP/IP V2.0 for OS/2 places itself in the Startup folder of the OS/2 Workplace 
Shell. We suggest to remove it from there and place it into the STARTUP.CMD 
file to make sure it does load before TCP/NetBIOS: 

@echo off 

call c:\tcpip\bin\tcpstart.cmd 

START "NetBIOS/2" C:\NETBI0S2\NBTCP IP_address IP_broadcast 
exit 



14.4 Configuration of TCP/NetBIOS 

To meet the requirements of NetBIOS sessions, commands, and names of your 
NetBIOS applications that you want to run over TCP/IP, you need to customize 
NBDRIVER.SYS. There are three parameters that can be specified: 

Parameter Meaning 

•s Number of NetBIOS sessions available to NetBIOS applications 

•c Number of NetBIOS commands available to NetBIOS applications 

•n Number of NetBIOS names available to NetBIOS applications 

The default value for each of the above parameters is 16. 

Once TCP/NetBIOS is running, it will show the amount of sessions, commands, 
and names that are available, for instance, the statement: 

DEVICE*=Ci \NETBI0S2\NBDRI VER. SYS -s 40 -c 95 -n 21 

in a CONFIG.SYS file will result in the following startup messages: 



— s. 

IBM NetBIOS Version 1.0.2 for TCP/IP for OS/2 

Licensed Materials - Property of IBM (R)* 

94F0534, 94F8535 (C) Copyright IBM Corp. 1991, 1993 
(C) Copyright Daniel Lanciani 1996, 1991, 1993 
All rights reserved. 

US Government Users Restricted Rights - 

Use, duplication or disclosure restricted by GSA ADP Schedule 

Contract with IBM Corp. 

*IBM is a registered trademark of International Business Machines Corporation 



NetBIOS driver release 1.3 
46 sessions, 95 comnands, 21 names 
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after NBTCP has been started. 



NBTCP.EXE provides the TCP/UDP NetBIOS as specified in the RFCs. It runs as 

an OS/2 window or full-screen application and takes the IP address and IP 

broadcast address of your workstation as mandatory parameters. 

Optional parameters to NBTCP.EXE are: 

Parameter Meaning 

•s scope The Scope string. This string defines the local name scope for 

NetBIOS names. 

•S domscope The Domain Scope string. This string is added to a NetBIOS 
name if NetBIOS broadcast and direct connection through use 
of the NAME file were both unsuccessful. The hitherto 
converted name is then passed on to a domain name server or 
a local hosts table. 

•b broadcastflle This file is loaded at startup. It contains a list of remote TCP/IP 
addresses, which the user wants to have included in 
broadcasts. The addresses are in other networks or 
subnetworks and can only be reached via routers. This file is 
needed to extend broadcasts across the router boundaries into 
other networks because normal broadcasts are limited to a 
single network. The TCP/IP address can be in dotted decimal 
format (9.67.38.81) or in domain name format 
(martin.itsc.raleigh.ibm.com). In the latter, a TCP/IP domain 
name server or a local host table will be used to find the 32-bit 
TCP/IP address. 

•n namefile This file is accessed at each search. New users can be added 
without restarting TCP/NetBIOS. This file contains a cross 
reference of NetBIOS names to TCP/IP addresses. The TCP/IP 
address can be in dotted decimal or in domain name format. 
The nodes in this file will be contacted in point-to-point mode 
and will not be included in broadcasts. Typically, this file can 
be used to access a server whose TCP/IP address is known. 

-d This parameter displays debug information and turns 

NBTCP.EXE into a monitor of NetBIOS control block (NCB) 
activity. This may be helpful for problem determination (NCBs 
are NetBIOS commands exchanged between NetBIOS nodes). 

The following shows an example of monitoring NCB activity with NBTCP: 
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NCB received: 
owner: 00080001 
vncb : 2958:32F8 
pncb : 88bf22f8 



com : 0xa0 [Async DatagramSend] 

retcode : Oxff [Conmand pending] 

lsn : 0 

num : 2 

buf : 004F:0010 

length : 384 

callname : 00 80 00 80 00 00 80 00 00 80 00 00 00 00 88 00 

name : WTR32229 . 57 54 52 33 32 32 32 39 20 20 20 20 20 20 20 00 

rto : 0 

sto : 0 

post : 0x0001 :FF20 

lana_num : 1 

cmd_cplt : 0xff [Ccmnand pending] 

reserve : 00 00 00 00 80 00 00 80 00 00 00 08 80 00 

J 



The following examples illustrate the use of scopes and the BROADCAST and 
NAME files: 

1. Specifying NBTCP parameters 

START “NetBI0S/2“ c:\NETBI0S2\NBTCP.exe -s itsc 

-S itsc.raleigh.ibm.com 
-b C:\NBTCPBRC 
-n C:\NBTCPNAM 

2. A sample broadcast file for TCP/NetBIOS 
9.244.5.1 

server. ti sc . vi enna . i bm. com 
server. i sc . Sydney .ibm.com 

3. A sample names file for TCP/NetBIOS 

NBTCPSRV 9.67.38.115 

NBTCPDOM cidserver.itsc.raleigh.ibm.com 

Note: Once TCP/NetBIOS is installed, all applications that use the standard 

NetBIOS interface are forced to use the TCP/IP protocol for access to the 
LAN. This necessarily requires that all nodes willing to participate in 
communications also switch to TCP/NetBIOS. 

For more information about TCP/NetBIOS, please see the IBM NetBIOS Version 1 
for TCP/IP for OS/2 User's Guide. 

The following figure shows how NetBIOS applications interface with 
TCP/NetBIOS. An example of an application using the DLL interface would be 
IBM Extended Services/2 VI. 0 Remote Database Services, and an example of an 
application using the device driver interface would be IBM OS/2 LAN Server 
V3.0. 
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Figure 170. Using NetBIOS Applications with TCP/NetBIOS 



14.5 Interoperability with IBM OS/2 LAN Server V3.0 

One of the IBM NetBIOS applications that can make use of TCP/NetBIOS is IBM 
OS/2 LAN Server V3.0. This program, however, is unique in the way it uses 
NetBIOS interfaces, since it may use both native and TCP NetBIOS. This is 
possible since LAN Adapter and Protocol Support provides a so called standard 
NetBIOS, as implemented with NETBI0S.0S2 (LAPS) or NBDRIVER.SYS 
(TCP/NetBIOS), and a so-called enhanced NetBIOS, as implemented with 
NETBEUI.0S2 (LAPS). 

The standard NetBIOS interface has originally been defined by IBM and is 
referred to as the NB30 interface by IBM OS/2 LAN Server V3.0. The name of 
the device driver is NETBIOSS. It is the one being used by most NetBIOS 
applications, especially those that have been developed using the specifications 
defined in the IBM LAN Technical Reference, and IBM NetBIOS APIs. 

The enhanced NetBIOS interface has originally been defined by Microsoft and is 
referred to as the LM10 interface by IBM OS/2 LAN Server V3.0. The name of 
the device driver is NETBEUI}. 

To tell IBM OS/2 LAN Server V3.0 which network protocol and interface to use, a 
statement in the \IBMLAN\IBMLAN.INI file is used that normally reads: 

netl - NETBEUI} , 0 , LM 10 , 32 , 50 , 14 

The meaning of this line is as follows: 

Parameter Meaning 

netl Logical network number; can range from 1 to 4 
NETBEUI} Name of the device driver interface to use 
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0 



Physical LAN adapter number (in the order they are bound in the 
[NETBEUI] section of the PROTOCOL.INI file) 

LM10 Name of the NetBIOS interface to call 

32 Number of NetBIOS sessions to allocate from the NetBIOS device 

driver 

50 Number of NetBIOS commands to allocate from the NetBIOS device 

driver 

14 Number of NetBIOS names to allocate from the NetBIOS device driver 

In order to make IBM OS/2 LAN Server V3.0 use TCP/NetBIOS, change the above 
statement to: 

netl = NETBIOSS, 0.NB30, 32, 50,14 
and provide enough NetBIOS resources: 

DEVI CE=C:\NBTCP\NBDRIVER. SYS -s 40 -c 95 -n 21 

In order to use both NetBIOS protocol stacks - native and TCP NetBIOS, add a 
line to the original IBMLAN.INI and tells IBM OS/2 LAN Server V3.0 to operate on 
a second logical network: 

netl = NETBEUI}, 0.LM10, 32, 50, 14 
net2 = NETBIOSS, 0.NB30, 32, 50, 14 



wrknets = NET1.NET2 



srvnets = NET1.NET2 

In this case, re-enable the use of the NETBEUI.OS2 device driver so that your 
CONFIG.SYS file now loads both NetBIOS interfaces again: 

DEVI CE=C : \ IBMC0M\PR0T0C0L\NETBEU I . 0S2 
DEVICE=C:\NBTCP\NBDRIVER.SYS 

To allow IBM OS/2 LAN Server V3.0 to operate on both NetBIOS protocol stacks, 
it is also required to add a "dummy" NetBIOS section to your PROTOCOL.INI file, 
and bind it to a LAN adapter, for instance: 

[NetBIOS] 

DriverName = NETBIOSS 
Bindings = IBMTOKjiif 

The following diagram illustrates the use of dual NetBIOS protocol stacks: 
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Figure 171. TCP/IP and NetBIOS 

The following figure shows the basic scenario of IBM OS/2 LAN Server V3.0 
using dual NetBIOS protocol stacks to connect two LANs through an IP network: 
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1. IBM OS/2 LAN Server V3.0 does not provide a bridge or router between the 
two NetBIOS protocol stacks. 

2. IBM OS/2 LAN Server V3.0 can interface the two NetBIOS protocol stacks on 
different physical LAN adapters as well. 

The test environments for this chapter is shown in 1.4, "ITSC Raleigh Test 
Environments" on page 11. 



14.6 Other TCP/NetBIOS Implementations 

The transport of NetBIOS traffic over a TCP/IP network is not an exclusive 
implementation for the OS/2 platform. 



14.6.1 DOS 

TCP/IP V2.1 for DOS offers, as a separate kit, an implementation of TCP/NetBIOS 
which is similar in terms of functions to the OS/2 implementation described in 
the previous section. 

TCP/NetBIOS for DOS is installed with the CUSTOM utility from the TCP/IP V2.1 for 
DOS product. Unlike the OS/2 implementation, the DOS TCP/NetBIOS does not 
employ a device driver to run NetBIOS over TCP/IP. It uses a TSR (terminate but 
stay resident) module called NBTCP.EXE which uses approximately 35K of 
memory. It also provides a NBDOWN.EXE program to remove itself from 
memory. 

With TCP/NetBIOS for DOS, you can, for instance, run the DOS LAN Requester 
program provided with IBM OS/2 LAN Server V3.0. This works in a similar way 
as described in 14.5, "Interoperability with IBM OS/2 LAN Server V3.0” on 
page 244. For our scenario, we used the same workstation as TCP/IP host 
cidserver and as LAN Server 3.0 domain controller WTRNBTCP. This server was 
thus made accessible to: 

• TCP/IP hosts using Telnet, FTP, REXEC, RSH 

• TCP/IP hosts using NFS 

• OS/2 and DOS LAN requesters using native NetBIOS 

• OS/2 and DOS LAN requesters using TCP/NetBIOS. 

14.6.2 AIX 

A NetBIOS PRPQ is available for AIX/RT and AIX Version 3. It provides a 
programming interface which allows users to develop their own NetBIOS 
applications. The AIX NetBIOS support is available for token-ring networks only. 
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Chapter IS. Extended Networking: X.25 and SNALINK 



This chapter describes the extended networking capabilities of TCP/IP V2.0 for 
OS/2 to connect to a wide area network. The X.25 and SNALINK connectivity is 
provided by the Extended Networking Kit of the product. 

The test environments for this chapter is shown in 1.4, “ITSC Raleigh Test 
Environments” on page 11. 



15.1 Connecting TCP/IP V2.0 for OS/2 to an X.25 Network 

An X.25 interface allows you to connect to an X.25 packet switching network on 
which you can use the TCP/IP protocols for communications. You can use most 
of the same TCP/IP applications over an X.25 network as if your host were 
connected to a LAN. 

To connect your OS/2 system to an X.25 network in order to use it for TCP/IP 
communications, you need the following: 

• PS/2 Micro Channel System 

• X.25 Interface Co-processor Adapter /A 

• Appropriate X.25 attachment cable 

• Subscription to an X.25 network (obtain from your local PTT) 

• Attachment to an X.25 network (obtain from your local PTT) 

• OS/2 2.x 

• TCP/IP V2.x 

• IBM Extended Services/2 V1.x or IBM Communications Manager/2 Vl.x 

• X.25 Interface Co-processor Adapter /A Option Diskette. 

Notes: 

1. The subscription to an X.25 network lists the necessary parameters that need 
to be specified in the configuration files for IBM Extended Services/2 Vl.x or 
IBM Communications Manager/2 VI. x, and TCP/IP V2.0 for OS/2 as shown 
later in this chapter. 

2. The attachment (modem) to an X.25 network (DCE; Data Circuit Terminating 
Equipment) determines the type of cable you need to attach the DCE to the 
X.25 Co-processor. 

3. The X.25 Co-processor acts as DTE (Data Terminal Equipment). 

4. Either IBM Extended Services/2 VI. x or IBM Communications Manager/2 Vl.x 
is required to provide the X.25 subsystem APIs; these are not provided with 
TCP/IP V2.0 for OS/2. 

The following figure shows how TCP/IP V2.0 for OS/2 uses the X.25 subsystem of 
Communications Manager: 



© Copyright IBM Corp. 1990 1992 1993 
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Figure 173. Communications Manager X.2S Subsystem used by TCP/IP V2.0 for OS/2 



15.1.1 X.25 Installation and Configuration 

OS/2 allows multiple X.25 adapters, but TCP/IP V2.0 for OS/2 allows you to 
assign only one IP address to an X.25 interface. 

The X.25 interface for TCP/IP V2.0 for OS/2 is part of the Extended Networking Kit 
of the product. You can install it either in addition to the Base Kit, or later on as 
a separate component. In that case, insert the Extended Networking Kit diskette 
into drive A: and enter. 

A:TCPINST 

You can likewise install the Extended Networking Kit from a remote drive, using, 
for instance, the remote installation method provided with TCP/IP V2.0 for OS/2, 
or IBM OS/2 LAN Server V3.0. 

Since you need IBM Extended Services/2 VI. x or IBM Communications 
Manager/2 Vl.x to provide the X.25 subsystem API used by TCP/IP V2.0 for OS/2, 
you first need to create a Communications Manager configuration file for X.25. 

To simplify that process, TCP/IP V2.0 for OS/2 provides the following sample 
configuration files: 

Sample Purpose 

X25ES1.CFG Configuration file for a local workstation using IBM Extended 
Services/2 VI .0 

X25ES2.CFG Configuration file for a remote workstation using IBM Extended 
Services/2 VI .0 

X25CM1.CFG Configuration file for a local workstation using IBM 
Communications Manager/2 Vl.x 

X25CM2.CFG Configuration file for a remote workstation using IBM 
Communications Manager/2 Vl.x. 

In order to use the sample configuration files, you need to copy them from the 
\TCPIP\ETC directory to the \CMLIB directory. The following figures guide you 
through that process using IBM Communications Manager/2 Vl.x and one of the 
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sample configuration files provided with the Extended Networking Kit 
(X25CM1.CFG): 

• Select Communications Manager Setup from the Communications Manager 
Group on your OS/2 desktop. Select a configuration file that you want to 
work with (in our case X25CM1.CFG), and reply with Yes to use that 
configuration file for this workstation. On the CM Configuration Definition, 
select X.25 from the Workstation Connection Type list, and X.25 APIs from 
the Feature or Application list: 




Figure 174. CM Configuration Definition for X. 25 



• This leads you to the Profile List Sheet for X.25: 
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Communications Manager Profile List Sheet 




Figure 175. CM Profile List Sheet for X.25 



• The first to configure is an X.25 link. One link has already been created in 
the sample configuration file, but you need to adjust definitions and 
parameters to meet the specifications of your X.25 subscription. If you use a 
different configuration file or create one from scratch, you must select Create 
on the X.25 Links menu, otherwise select Change: 




Figure 176. Configure X.25 Links 

• Configure the X.25 link parameters according to your X.25 subscription. 

This selection allows specification of both link connection and 
network-related information. Link connection information specifies 
characteristics of the link itself, while network-related information must be 
specified before the link profile can be used. 

Setting Meaning 

Link Name The name of the link profile to create. Duplicate names 

are not allowed. 
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Adapter Type Select X.2S 

Slot number The actual PS/2 slot number where the X.25 adapter is 

installed. 

Network type Specify the characteristics of the packet switching 

network that X.25 is connected to. Communications 
Manager provides a Help panel giving the appropriate 
value to enter for the main X.25 networks in the world. 
Most networks have the characteristics of network type 
1; the ones that have different values are the following: 



Table 18. X.25 Network Types 


Network 


Type 


Austria DATEX-P 


5 


Germany DATEX-P 


6 


Japan ISDN 


9 


United Kingdom PSS basic 


2 


United Kingdom PSS extended 


3 



United States TELENET | 4 

Enter this value if your network is not listed. 

Local CCITT compliance This item specifies whether the X.25 network 

complies with the 1980 or 1984 CCITT recommendation. 

Link set up mode This item specifies whether, on the network, the DTE or 
DCE is responsible for initiating the link connection. 
Select DTE to indicate that the DTE should actively poll 
the network by sending an SABM (Set Asynchronous 
Balance Mode) at intervals. Select DCE to indicate 
that the network actively polls the DTE by sending an 
SABM at intervals. In this case, the DTE will remain 
passive until an SABM command is received. 

Local DTE address This item specifies the address that was assigned to 
the DTE when subscribing to the network. Up to 15 
numeric characters are allowed. 

Note: If the Data Network Identification Code (DNIC, 

which specifies the country and the 
telecommunications service within the country) 
is required, the first four characters are used for 
this purpose. The DNIC is not always required. 
Local calls or a private network use their own 
addressing method. 
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Figure 177. Configure X.25 Link Parameters 



• The following selection allows specification of the range of logical channel 
numbers that can be assigned to PVCs and SVCs. This information can be 
obtained from the form that the network provider returned when access to 
the network was requested. 




Figure 178. Configure Virtual Circiut Ranges for X. 25 

• The following selection allows specification of information related to the X.25 
frame level. This includes the frame sequence modules, window size, retry 
count, and timeout values. These items are related to the link (frame) level, 
and care should be taken not to confuse them with similar named items in 
the SVC/PVC Window Sizes menu. 
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Figure 179. Configure Frame Values for X.25 



The following selection allows specification of timeout values for the X.25 
packet level. 




Figure 180. Configure Packet Timeout Values for X.25 

• The following selection allows specification of retry counts for the X.25 
packet level. 




Figure 181. Configure Retry Counts for X.25 

• The following selection allows specification of information related to the 
link's virtual circuits. The SVC packet sizes for TCP/IP should be set to 1024. 

Note: Packet sizes and window sizes can only be negotiated if subscribing 
to the flow control parameter negotiation facility. 



Chapter 15. Extended Networking 255 







Figure 182. Configure SVCIPVC Packet Sizes for X.25 

• The following selection allows specification of information related to the 
link's virtual circuits. It consists of the packet sequence number modules, 
and window sizes. 




Figure 183. Configure SVC/PVC Window Sizes for X.25 

• The following selection allows specification of information related to your 
modem: 
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Setting Meaning 

Use Transpac V.32 modem This item specifies whether the link is connected 
through a VX32 modem provided by the French Transpac 
network. The VX32 modem supports either one incoming 
SVC or up to eight outgoing SVCs. If an incoming call is in 
progress, no outgoing calls can be placed. If an outgoing 
call is in progress, no incoming calls can be received. No 
PVCs are supported. Additionally, you are prompted for a 
Connection timeout, indicating the amount of time the 
modem will attempt to connect to the network before 
discontinuing. 

Notes: 

1. See Transpac VX32 modem documentation for details of 
the link profile parameter values that are needed when 
using this equipment. The semi-automatic dialing 
option, manual dialing option, and SVC assignments are 
not supported. 

2. If you configure X.25 over ISON, the Transpac VX32 
modem cannot be selected. 

Operation mode This item specifies whether the PS/2 should operate in DTE 
or Partner mode. Select DTE when connecting a PS/2 to a 
network. Partner mode allows connection of a PS/2 to 
another X.25 DTE directly, for example, through a modem 
eliminator or a pair of modems without an intervening 
network. When in partner mode, a PS/2 acts like a DCE. 
This allows a high-speed point-to-point connection with 
another X.25 DTE. 

Note: When connecting two PS/2s back-to-back (using two 
modems or one modem eliminator), one must be 
configured as DTE and the other as partner. Except 
for the DTE addresses, all other link parameters 
configured for the two machines must be identical. 

Initial mode of links This item specifies how the X.25 support will start the 
link. Select Auto-connect or Disconnect. In the 
auto-connect mode, and if the link is not already connected, 
the X.25 support attempts to connect the link (at the frame 
level) whenever an application requires the link to: 

— Make a call 
- Allocate a PVC 
— Receive an incoming call. 

If auto-connect is selected, a prompt will ask for the amount 
of time that the X.25 support delays disconnecting an 
auto-connected link. 

Note: If using the Transpac** VX32 modem, it is 

recommended that a 55-second disconnection delay 
be specified. Similarily, the X.25 support disconnects 
a link in auto-connect mode when it is not being used 
by any application, namely, when: 

— All SVCs are cleared 
— All PVCs are freed 

— No application is listening for incoming calls. 
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In the Disconnect mode, the link is disconnected and will not 
be connected by the X.25 support until Connect X.25 
Physical Link or Autoconnect X.25 Physical Link is selected 
from a Communications Manager X.25 Link Profile menu or 
API. 

• You cannot configure ISDN parameters if you are using a standard X.25 
connection, only if you are configuring for X.25 over ISDN. 

• The next to configure are the X.25 directories. You need one local and one 
remote directory entry for TCP/IP. One of either entries is already contained 
in the sample configuration file but may require changes: 




Figure 185. Configure X.25 Directory Entries 

• The local directory entry allows assignment of a name to a local DTE. By 
referring to this name when coding X.25 API verbs, it is possible to write 
applications that are independent of the local DTE address. Since a PS/2 
workstation can be connected to multiple X.25 networks, each local directory 
entry allows specifying a different network address (and address extension) 
for each of up to eight different network connections. Note that local 
directory entries are not required (or used) by SNA applications or SNA APIs. 



2S8 



TCP/IP V2.0 for OS/2 





Figure 186. Configure X.25 Local Directories 



• This entry is the content of the X25IP file. If you have more than one local 
entry for different SVCs or X.25 adapters, the names of the entries must also 
be in the X25IP file. 




Figure 187. Configure Local Directory Entry for X.25 

• The remote directory entry (SVC) allows the association of a name with a 
remote DTE when communicating using an SVC. This name is the entry to 
the X25DIR file, which also contains the corresponding IP address of the 
remote host. The X25DIR file contains each remote directory entry. 
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Figure 188. Configure Non-SNA SVC Directory Entry for X.2S 

• Finally, you need lo define an X.25 routing table for TCP/IP. The sample 
already contains one that might need to be changed to suit your actual 
configuration. The X.25 feature can run up to 40 applications concurrently. 
When it receives an incoming call packet from the network, it must decide 
which application to route the call to. The X.25 feature uses the Routing 
table to make this decision. Calls are routed to a particular application by 
the process of the X.25 support matching fields in the incoming call packet 
with corresponding fields in the Routing table entries that the application 
specifies. 



vX. 2 5 * Rout i rig viable 



To create a new X.25 routing table entry, select Create. r;Sete 





Figure 189. Configure X.25 Routing Tables 



• The name of the route (ROUTE1) is the entry to the X25RTE file, which 
contains all routes to the corresponding remote hosts. 
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Figure 190. Configure Routing Table Entry for X.25 



Setting 
Link name 
Type 

Call user data 



Meaning 

Name of the X.25 link that this routing table entry applies to 
Type of application using this routing table. Select Non*SNA 
for TCP/IP. 

Enter CC for TCP/IP. 



In addition to the configuration file, you need to copy the ICAAIM.COM file from 
the X.25 Co-processor option diskette to the \CMLIB directory. When IBM 
Extended Services/2 V1.x or IBM Communications Manager/2 VI. x is configured 
for X.25, it places the following statement in the CONFIG.SYS file: 

DEVICE=d : \CMLIB\ICARICIO.SYS 

where d is the drive where Communications Manager is installed. This device 
driver will actually download the ICAAIM.COM file into the X.25 Co-processor at 
startup time of your OS/2 workstation. 

After a Communications Manager configuration file has been created for X.25, 
you have to configure the X.25 connection for TCP/IP V2.0 for OS/2. This can 
easily be done from the Configuration Notebook contained in the TCP/IP folder 
on your OS/2 desktop. 

The following shows the first page of the X.25 Configuration Notebook: 
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Figure 191. TCP/IP Configuration Notebook for X.2S, Page 1 

Setting Meaning 

IP Address Your local IP address that will be assigned to the X.25 interface 
by the IFCONFIG command 

Subnet Mask The subnet mask that will be assigned to the X.25 interface by 
the IFCONFIG command 

MTU The maximum transmission unit size for the local X.25 interface. 

A value of 576 is recommended. 

Timeout The period of time before an X.25 SVC will close due to 

inactivity. A value of 0 means no timeout. 

The following shows the second page of the X.25 Configuration Notebook: 
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Figure 192. TCP/IP Configuration Notebook for X.25. Page 2 



Setting Meaning 

X25IP Local directory that identifies a local DTE address with an 

X.25 link 

X25RTE Routing table that determines which incoming X.25 calls 

are to be routed to the TCP/IP application. 

Destination Address Associate a remote DTE address to an IP address 
Remote Directory Specify the directory to direct outgoing IP packets to a 
remote DTE address. 

The Configuration Notebook will make changes to the following files: 

File Purpose 

\TCPIP\ETC\X25IP Contains the directory entry name of the local entry point 
with its link to the local DTE address 

\TCPIP\ETC\X25RTE Contains the routing table entry name 

\TCPIP\ETC\X25DIR Contains the directory entry name of the remote entry. 

\TCPIP\BIN\X25.CMD Command file that starts and initializes the X.25 interface 
for TCP/IP. It executes the following programs: 

• X25IO.EXE 

• XIOWAIT.EXE 

• IFCONFIG.EXE 

The X25IO program is the driver that connects the TCP/IP interface to the X.25 
interface, it must be started after Communications Manager and before 
IFCONFIG, and it must stay up as long as the TCP/IP connection on the X.25 
interface is required. The following shows an active X25IO window: 
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X25: Available using INET interface unit #1. X25I0 version 2.6 






The XIOWAIT program is used to make sure that IFCONFIG does not try to 
initialize the X.25 interface before X25IO has finished connecting to the X.25 API. 

The IFCONFIG statement assigns an IP address to the X.25 interface on your 
workstation. To configure the X.25 interface, you must enter the IP address, the 
subnetmask parameter is optional. The maximum transmission unit (MTU) size 
should be set to 576 which is the default. 

The following shows the X25.CMD on host routx25: 

start x25io.exe 
xi owai t 

ifconfig x25 9.67.38.1 netmask 255.255.255.192 mtu 576 

To start the X.25 interface automatically, you need to call X25.CMD from a 
command file that is executed at startup time of your workstation, for instance 
STARTUP.CMD. When you do that, please remember the following: 

Notes: 

1. Communications Manager must be running before X25.CMD. 

2. The X.25 link must be up, or X25IO will fail. 

3. If you use static route statements on your X.25 TCP/IP connection, run 
X25.CMD before SETUP.CMD since the ROUTE command will fail on an 
interface that has not been initialized. 

The following shows the STARTUP.CMD file on host routx25: 

start c:\onlib\cmstart.exe x25cml 
cmwait -s e 

call c:\tcpip\bin\x25.cmd 
call c:\tcpip\bin\setup.cmd 
exit 

The CMWAIT statement causes any program that wants to access 
Communications Manager APIs to wait until it is up and host session E is 
started. This may be different in your configuration and is no guarantee that the 
X.25 link has been successfully activated, but it helps to automate 
communications startup. 

If your workstation is not connected to a LAN and if X.25 is the only interface on 
your workstation used for TCP/IP, you must add the following statements to your 
CONFIG.SYS file: 

DEVICE=dri ve:\tcpi p\bi n\ I NET. SYS 

and 

DEVICE=dri ve:\tcpip\bin\IFNDISNL.SYS 
In this case you do not need to install LAPS. 

When you have finished configuring Communications Manager and TCP/IP V2.0 
for OS/2, restart your workstation. 
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For a more detailed discussion of how to configure Communications Manager, 
TCP/IP, and the X.25 interface, please refer to the TCP/IP V2.0 for OS/2 Extended 
Networking Guide. 

15.1.2 X.25 Limitations for TCP/IP V2.0 for OS/2 

You should consider the following recommendations when using X.25: 

• X.25 Permanent Virtual Circuits (PVCs) are currently not supported. 

• A maximum of 16 active Switched Virtual Circuits (SVCs) are supported. An 
SVC will become inactive after a specified period of inactivity. 

• The MTU size is not negotiated with the remote host. 

• The Department of Defense Network (DDN) algorithm is not used to convert 
IP addresses to DTE addresses. The conversion of IP addresses to DTE 
addresses is defined in the X25DIR file. 

15.1.3 Starting the X.25 Connection 

Before you initialize the X.25 interface for TCP/IP, Communications Manager 
must be running to provide you with the X.25 API interface. 

Usually, an X.25 link is established when both ends are activated at the same 
time. This may, however, not always be feasible, or the link may drop during 
operation for several reasons. In that case, the Subsystem Management of IBM 
Extended Services/2 Vl.x or IBM Communications Manager/2 V1.x can be used 
to activate or re-activate an X.25 link. 

The following shows the Subsystem Management window of IBM 
Communications Manager/2 VI. 0: 




Figure 193. Communications Manager Subsystem Management 

The following figure shows an X.25 link used for TCP/IP. It is active and 
connected, and there is no line activity at the moment: 
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Figure 194. Manage X.25 Physical Links 

If that still fails, you do need somebody on the other side of the X.25 connection 
in order to bring the link back up on either side simultaneously. 

After the X.25 interface is successfully started you can start TCP/IP V2.0 for OS/2. 
If you start it before, initialization will fail and also starting of TCP/IP services. 

15.1.4 Using the X.25 Connection 

Make sure that the X.25 interface on the other end of your link is also initialized 
using IFCONFIG before you start using this connection. To verify this, try to PING 
the remote address on the link. 

In most cases, a workstation with a connection to a wide area network is used to 
route traffic from a LAN to remote destinations. You can route TCP/IP across the 
X.25 link using either the ROUTED daemon or static route statements. Static 
routes should be preferred, if: 

• The bandwidth of the X.25 link is narrow 

• You want to use the X.25 link cost-effectively 

• Your partner on the X.25 link does not support the RIP protocol. 

ROUTED can be used if the above points do not apply to your configuration, and 
if you want to use dynamic routing. ROUTED uses the Route Information 
Protocol (RIP) to exchange routing information to other hosts, running ROUTED. 

It transmits its routing table every 30 seconds on all links that your host is 
attached to and therefore causes network traffic that is not directly related to 
TCP/IP applications. 

For more information on routing, please see Chapter 16, "Network Management 
and Interconnection" on page 293. 
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15.2 Connecting TCP/IP V2.0 for OS/2 Across an SNA Network using SNALINK 

This version of TCP/IP for OS/2 includes an SNALINK interface, which allows you 
to connect TCP/IP networks across an SNA network. 



The Extended Networking Kit provides an APPC program which will send and 
receive TCP/IP packets to another SNA node. This APPC program is designed to 
run on IBM Communications Manager/2 VI. x or IBM Extended Services/2 VI. x, 
which provide the base SNA functions. 



There are many files supplied with the Extended Networking package to provide 
SNALINK functions. Most of these files are example configurations. Instead of 
using these example configurations, we document the steps that we took to 
create a working SNALINK from scratch, and describe our choices in the 
configuration so that you may understand them fully. The main files shipped with 
the Extended Networking kit for SNALINK are: 



File/Directory Description 

BIN\SNALIO.EXE An APPC program which sends and receives TCP/IP 

packets over an SNA link. 



BIN\SNALWAIT.EXE A utility which waits until SNALIO is running. 
BIN\SNALIO.ICO Icon for SNALIO.EXE 

ETC\SNALIP.CFG Text file created by the Configuration Notebook program 
which contains APPC values that will be used by 
SNALIO.EXE. 



This figure illustrates how TCP/IP packets are sent over the SNA Link: 
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Figure 195. TCP/IP over SNA Link Protocol Stack 

In this diagram, we show that all TCP/IP packets are sent through SNALIO. But 
you can also send TCP/IP packets to IFNDIS.SYS at the same time. This means 
that you can have a conventional IP link and SNA link working on a machine 
concurrently. 
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Your SNA Link can be established over any medium supported by 
Communications Manager for LU6.2 communications. For example: 

• LAN 

• SDLC 

• X.25 

15.2.1 Configuring Communications Manager 

In this section, we provide instructions to configure Communications Manager for 
these example scenarios: 

• OS/2 workstation to OS/2 workstation 

• OS/2 workstation to OS/2 workstation via VTAM 

The steps to set up these configurations are cumulative. We explain the OS/2 to 
OS/2 workstation scenario, and then the changes necessary for each of the other 
scenarios. 

Each of the scenarios have been set up in the USIBMRA SNA network. 

15.2.1.1 OS/2 Workstation to OS/2 Workstation 

In this scenario we set up a direct SNA link between two OS/2 workstations 
which are physically connected using token-ring. This type of connection does 
not require any changes to the VTAM system controlling the SNA network. 
However we use naming conventions recommended by our network 
administrator, so that we may easily change our configurations for the other 
scenarios described later in this section. 

We set up each machine with identical hardware and software. Each machine is 
equipped with a token-ring adapter and has these software packages installed: 

• Operating System/2 V2.1 

• TCP/IP V2.0 for OS/2 Base Kit 

• TCP/IP V2.0 for OS/2 Extended Networking Kit 

• IBM Communications Manager/2 Vl.x 

Figure 196 on page 269 illustrates the SNA connections required for this 
scenario. This is an explanation of the names used in this figure and how they 
relate to conventions in Communications Manager Setup. 

Name Description 

Alias Alias of Logical Unit Sessions (LU Name) 

LU Logical Unit Sessions (LU Name) 

SSCP SSCP VTAM ID (Partner Network Node for connections through VTAM) 
CP CP Name (Network Node Name) 

LAA Locally Administered Address (Token-Ring Address) 
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Alias: SNALM 
LU: W3224000 



Alias: SNALS 
LU: W3227500 



CP: WTR32240 [ ] CP: WTR32275 



LAA: 400000032240 LAA: 400000032275 

Figure 196. OS/2 to OS/2 Workstation SNA Link Configuration 

Once these configurations are set up, the SNALIO program supplied with the 
Extended Networking Kit will send and receive information to and from the LUs. 

Here are the steps that we used to configure Communications Manager/2 for this 
scenario. We fully illustrate the set up of machine WTR32275, and also describe 
the parameter values that should be used when configuring machine WTR32240: 

1. Start Communications Manager Setup from the Communications Manager/2 
folder on your OS/2 desktop. 




Figure 197. Communications Manager Setup 

2. Click on Setup. 

3. Type in the name and description of the configuration. 

Parameter Value 
Configuration SNALINK2 
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Description For TCP/IP over SNALINK 




j^ep; 

Figure 198. Open Configuration 
Click on OK. 

4. We are creating an entirely new configuration: 



40S/2?Communi'catiohsT4anagefW|^^^^ :■ 



I '^4 eXhe configuration C:\CMLIB\SNALINK171 
V A ,-7>0yas not found. Would you Jike^j 




Figure 199. Create a New Configuration 



Click on Yes. 

5. We recommend that you use the Advanced Configuration option for this 
configuration. Click on Options, Use advanced configuration and On: 
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Figure 200. Communications Manager Configuration Definition - SNALINK2 



6. In this example, TCP/IP for OS/2 will use an APPC link across a token-ring 
interface, so you should select Token-ring or other LAN types as your 
Workstation Connection Type and APPC APIs as your Application. 
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ICommunicitldrisJ^ -Definition ’^SNAUNK2 



-'Options Gateway Help 




Figure 201. Communications Manager Configuration Definition - SNAUNK2 



Click on Configure. 

7. You will now configure each profile in the Communications Manager Profile 
List Sheet: 
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Figure 202. Communications Manager Profile List Sheet 



Select DLC • Token-ring or other LAN types, and click on Configure 

8. This panel allows you to configure the interface between the SNA protocol 
layers in Communications Manager/2 and the token-ring adapter on your 
machine. Type in your C&SM LAN ID. This is usually the same as your 
Network ID. We used USIBMRA. 
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Figure 203. Token Ring or Other LAN Types DLC Adapter Parameters 
Click on OK. 

9. Select SNA local node characteristics. 




Figure 204. Communications Manager Profile List Sheet 
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Click on Configure. 




10. This panel allows you to configure the SNA network values for this 
workstation: 


Parameter 


Our Value 


Network ID 


USIBMRA 


Local Node Name 


WTR32275 


Local Node ID 


32275 


When we configured machine WTR32240, we used these values: 


Parameter 


Our Value 


Network ID 


USIBMRA 


Local Node Name 


WTR32240 


Local Node ID 


32240 


Ensure that these values comply with your network coordinator's SNA 
naming convention. Click on OK. 




Figure 205 . Local Node Characteristics 



11. Select SNA Connections. 
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Figure 206. Communications Manager Profile List Sheet 



Click on Configure. 

12. This panel is used to configure SNA connections to other workstations. We 
configure a connection to machine WTR32240. Select To Peer Node. 
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Figure 207. Connections List 
Click on Create. 

13. Select Token-ring or other LAN types. 






Select the local adapter to be used for this connection. |;| 
Adapter Type - Hf 



ToKeirilrin^ 



•Ethernet (ETHERAND) network 

PC Network 

Twinaxial 

SDLC Adapters 0,1 Regular or User-dialed ISDN 
SDLC Virtual Port for Auto-dialed ISDN (adapters 2-127) 



18 li: 



Configured Yes 

Adapter number [6 \jf (8-1) 





Figure 208. Adapter List 



Click on Continue. 



14. These are the values that we used to configure machine WTR32275: 
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Parameter Our Value 

LAN destination address 400000032240 

Partner Network ID USIBMRA 

Partner Node Name WTR32240 

Optional Comment Direct SNA Link via TR to Martin's machine 

15. We used these values when we configured machine WTR32240: 

Parameter Our Value 

LAN destination address 400000032275 

Partner Network ID USIBMRA 

Partner Node Name WTR32275 

Optional Comment Direct SNA Link via TR to Scott's machine 







m 




Link name 


LINK0001 




T r : : 'z- ~ 


• •* f - 


LAN destination address (hex) 1S| 

; 


40OOOO032240 






Partner network ID 


USIBMRA 


□ 




: : * 


i m , , 






(Required for partner? I 


Partner node name | 


WTR32240 




LU definition) 




Optional comment 






| :L “ 


* 


||Direct SNA Link via TR to Martin's Machine 




OK | Define Partner LUs... ; Cancel [ l Help 


■ 















Figure 209. Create a Connection to a Peer Node 
Click on Define Partner LUs... 



16. This panel allows you to configure a Partner LU at the other end of the 
connection. 

You should ensure that you configure any partner LUs on this panel. Partner 
LUs can also be configured in the SNA features profile list, but SNALIO 
needs to know which connection can access the partner LU. 

These are the values that we used for machine WTR32275: 

Parameter Our Value 

LU name W3224C00 

Alias snalm 

These are the values that we used for machine WTR32240: 

Parameter Our Value 
LUname W3227500 
Alias snals 
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Click on Add. You should now see the partner LU in the list on the right-hand 
side of the panel: 









ffTo'add a Partner LU, enter the LU name, alias; and comment Then select 

^ i '%*/.* WsiBSM 

KTd' changed Partner LU, select an LU from the list, change the LU name!^' : 
^ ;Kd/or comment fields SndMect^hangeliiigj^^ 



fmf 1 ^ W3224000 

— P 

y < O&\*0 (»L' 




Figure 210. Create Partner LUs 



Click on OK, and the click on OK again from the Create a Connection to a 
Peer Node panel. 

Click on Close. 

17. Select SNA Features. 
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Figure 211. Communications Manager Profile List Sheet 



Click on Configure. 
18. Select Local LUs. 
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FeaturesjList 



To create, change, or delete a definition of a feature, select a list item, I 
then choose the appropriate action. : - 

rSNAfeature information 
Features 




Partner LUs 
II Modes 

I Transaction program definitions 
Transaction program defaults 
| Transaction program security 
I Conversation security 
I LU to LU security 
1 CPI Communications side infornjptj 



Figure 212. SNA Features List (Local LUs) 



Click on Create. 

19. This panel allows you to create a Local LU. 
We used these values on machine WTR32275: 
Parameter Our Value 
LUname W3227500 
Alias snals 

We used these values on machine WTR32240: 

Parameter Our Value 
LUname W3224000 
Alias snalm 
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Figure 213. Create a Local LU 

Click on OK. 

20. Select Modes. 



^SN^Rje'ature'sItlist 






;;to create, change, or delete a definition of a feature, select a Ust Item, 
then choose the appropriate action. 1111 1 



SNA feature information- 
features 

Local LUs~ 

Partner LUs 



Modes 



Transaction program definitions 
Transaction program defaults 
Transaction program security 
Conversation security 
LU to LU security 
CPI Communications side informat 



Definition 

b"CanhT“ 

ttBATCH 
ttBATCHSC 
» INTER 
I ItlNTERSC 
CPSVCMG 
jSNASVCMG 



Comment: 



Create!; 



Figure 214. SNA Features List (Modes) 



Click on Create. 

21. This panel allows you to create a mode definition. We define our own mode 
definition, which is also used later for our connection through VTAM. We 
create a mode definition DSIL6MOD with default values. 
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Figure 215. Create a Mode Definition 



Click on OK. 

22. Select Transaction program definitions. 






To create; change, or delete a definition of a feature, select a Ust Item, 
then choose the appropriate action. - 



rSNA feature inf ormation- 
Features 



Definition 



Local LUs 
Partner LUs 
Modes 



[Transaction: program rdefinitions 



Transaction program defaults 
Transaction program security 
Conversation security 
LU to LU security 
CPI Communications side informal 




Delete i I Close | | Help 



Figure 216. SNA Features List (Transaction program definitions) 

Click on Create. 
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23. This panel creates a definition of the APPC Transaction program 
(SNALIO.EXE). You should use these values: 

Parameter Value 

Transaction Program (TP) Name IPXPORT 

OS/2 program and path and file name C:\TCPIP\BIN\SNALIO.EXE 

Icon path and file name C:\TCPIP\BIN\SNALIO.ICO 



-sCrea tesal^ r^sac tionlRtrogr^^ 



Transaction program definition^ 



IPXPORT 



s' < s h !> 



Jransactlon program (TP) name 

OS/2 program path and file name j |C:\TCPIP\BIN\SNALIO.EXE 
■Optional comment ' 



|[ 



iM.i 



. . 



llllisiii! 



..A 






yx-lWWi":! 



optional values- 

;® Conversation security required 
Erogram parameter string 
Icon path and file name : 



| 



CAT CPIP\BIN\SN ALIO.ICO 






Eontlnue^j [Cancel | ] Help 




5 “ ~ r.-.. 






Figure 21 7. Create a Transaction Program Definition 



Click on Continue. 

24. You will start SNALIO from a command prompt, hence you should select 

Background and Queued, operator started. 
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Figure 218. Create Additional TP Parameters 



Click on OK. 
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25. Close each panel for Communications Manager Setup. 

15.2.1.2 OS/2 Workstation to OS/2 Workstation through VTAM 

In this scenario we set up an SNA link between two OS/2 workstations via a 
VTAM host. We still use token-ring for all physical connections. However, if 
required you could connect each workstation to VTAM using any of these media: 

• LAN 

• SDLC 

• X.25 

This type of connection through VTAM is not normally adopted in these 
circumstances. It is easier and more efficient to connect the workstations directly 
across the token-ring as described in the previous section. VTAM is normally 
used to form an SNA link between two workstations when: 

• They are physically located in different geographic locations 

• They use different mediums to connect to the network, for example one of 
the workstations is connected via token-ring and the other is connected via 
SDLC to the SNA network. 

We have set up this scenario so that you can easily compare the setup required 
to a direct peer connection. 




Figure 219. OS/2 to OS/2 Workstation via VTAM SNA Link Configuration 

1. Follow steps 1 to 6 in 15.2.1.1, "OS/2 Workstation to OS/2 Workstation” on 
page 268. 

2. Select SNA connections. 

Click on Configure. 

3. Our previous configuration used a direct connection between two OS/2 
workstations for the LU6.2 conversations used by SNALIO. We need to delete 
this connection. Select To peer node and then LINK0001. 
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Figure 220. Connections List 

Click on Delete. 




Figure 221. Delete a Connection Confirmation 
Click on Delete. 

4. We need to define a connection via the host system, so we select To host, 
and click on Create. 

5. Select Token-ring or other LAN types, and click on Continue 

6. These are the values that we used to configure machines WTR32275 and 
WTR32240; 

Parameter Our Value 

Link name HOSTOOOI 

LAN destination address 400001240001 
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Partner Network ID 
Partner Node Name 
Optional Comment 



USIBMRA 

RAI 

SNA Link via VTAM to Martin's machine 




Figure 222. Create a Connection to a Host 



Click on Define Partner LUs... 

7. This panel allows you to configure a Partner LU at the other end of the 
connection. 

You should ensure that you configure any partner LUs on this panel. Partner 
LUs can also be configured in the SNA features profile list, but SNALIO 
needs to know which connection can access the partner LU. 

These are the values that we used for machine WTR32275: 

Parameter Our Value 

LUname W3224000 

Alias snalm 

These are the values that we used for machine WTR32240: 

Parameter Our Value 
LUname W3227500 
Alias snals 

Click on Add. You should now see the partner LU in the list on the right-hand 
side of the panel: 
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Figure 223. Create Partner LUs 



Click on OK, and then click on OK again from the Create a Connection to a 
Host panel. 

Click on Close. 

8. Close each panel for Communications Manager Setup. 



15.2.1.3 OS/2 Workstation to MVS 

When you connect OS/2 to MVS using the SNALINK feature of the Extended 
Networking Kit, you should first install the MVS PTF for MVS APAR PN44647. 

If you do not apply this APAR, the following may occur: 

• When an OS/2 user tries to activate the SNA LU 6.2 sessions from the 
Communications Manager SNA subsystems management, the sessions 
remain inactive. 

• No TCP/IP traffic can use the SNALINK. 

This occurs because the Transaction Program (TP) Names on OS/2 and MVS are 
different. 

This APAR has no effect on SNALINK connections from one OS/2 system to 
another OS/2 system. This information is also documented in this file shipped 
with the product: 

\TCPIP\ETC\README.XTN 
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15.2.2 Configuring TCP/IP 

1. Start the TCP/IP Configuration panel from the TCP/IP desktop folder. 

2. Click on the SNALINK tab. 




Figure 224. SNA Link LU6.2 Connections 



Click on Add. 

3. Type in: 



Parameter 


Value 


IP Address 


9.67.32.1 


Destination LU Name 


snalm 


Timeout 


0 


Mode Name 


DSIL6MOD 


Define as a Dependant LU 


Do not tick 


Local LU Name 


snals 


Start Session at Initialization 


Off 
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Figure 225. SNAUNK LU6.2 Interface Parameters - Add 



Click on Add. 

4. You should now see the link listed in the LU6.2 Connections: 



290 TCP/IP V2.0 for OS/2 





Figure 226. SNALINK LU6.2 Interface Parameters - Add 



5. Double click on the top left-hand corner of the panel. This will close the 
Configuration panel. Click on Save to ensure that your changes are made. 

6. You can manually view the file that we have just configured by typing this 
command from an OS/2 command prompt: 





[C:\tepip\etc]type snallp.cfg 

* Destination Destination Timeout Hode INIT DEP Local 

* IP Address LU Name Name DATA INDEP LU Name 

*>SS8BBaBBBIIIBBBISSSSSe8aaa8IBeBnSBSSBBBCSeSS»IBIH8B8S38Btt 

9.67.32.1 snalm 0 DSIL6K0D INIT INDEP snals 

J 



You should ensure that this file contains the configuration information. If it 
does not then should create one manually, which looks similar to the 
configuration created in this example. 



15.2.3 Starting 

1. Start SNALIO.EXE from an OS/2 command prompt: 



— 
[C:\tcpip\bin]snal io 

SNA2G09I: Parsing the configuration file "\tcpip\etc\snalip.cfg". 

SNA2010I: Successfully parsed the configuration file. 

SNALIO: Available using INET Interface unit #2. SNALIO version 2.0 

SNA20G0I: SNALINK Interface now available. 

SNA20D4I: Waiting for an incoming ALLOCATE request. 

SNA2006I: Session allocated successfully to remote LU "snalm ", 

V J 
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2. In a separate OS/2 session, run these commands: 

Command Purpose 

SNALWAIT This will ensure that SNALIO has started before you run the 
IFCONFIG command. 

IFCONFIG This will configure an IP address to use the SNALINK. 

NETSTAT This will show the status of the IP address just configured with 
IFCONFIG. 

Your OS/2 session will look similar to: 



/ 


\ 


[C:\tcp1p\bin]snalwait 




[C:\tcp1p\b1n] Ifconflg snal 9.67.32.2 netmask 255.255.255.192 




[C:\tcpip\bin]netstat -a 

addr 9.67.38.106 interface 0 mask ffffffcG broadcast 


9.67.38.127 


addr 9.67.32.2 interface 12 mask ffffffcG broadcast 


0.8.G.G 


V 


J 



15.2.4 Verifying the Connection 

Once the connection has been started. You can check if it works by executing a 
PING: 

ping 9.67.32.1 10 5 



If your response from a PING is successful, then you may use the address at the 
other side of the SNALink like any other TCP/IP address on your network. We 
established a Telnet session using this command: 

telnet 9.67.32.2 

This is the result of the Telnet session establishment: 



N 

OS/2 Version 2.1 (martin) 

log in smart in 
password: 

6 

[<martin>-C:\] 

/ 
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Chapter 16. Network Management and Interconnection 



This chapter describes the capabilities and tools provided with TCP/IP V2.0 for 
OS/2 to manage resources in a TCP/IP environment, and how to route TCP/IP 
traffic between different networks. The following programs are provided for 
those purposes: 

• SNMP 

• SNMPGRP 

• PMTRAPS 

• PING 

• PM PING 

• NETSTAT 

• ARP 

• RPCINFO 

• ROUTE 

• ROUTED 

• BOOTP 



16.1 SNMP Concepts 

Simple Network Management Protocol (SNMP) defines an architecture that 
consists of network management stations (SNMP monitors or clients) and 
network elements (SNMP agents or servers). Refer to Figure 227 on page 294 
as an example of an implementation for the following description of the SNMP 
concepts. 

SNMP monitors, collects and analyzes data sent by SNMP agents residing on 
nodes in the network. This data can specifically be requested by an SNMP 
monitor by querying an SNMP agent for desired information (sending a GET or 
GET_NEXT command). The agent responds with the requested data 
(GET_RESPONSE). 

The collection of all the data that can be obtained from an SNMP agent is called 
the Management Information Base (MIB). The MIB defines objects that are 
relevant to a TCP/IP environment, such as packet counts and routing tables, and 
divides them into the following groups: 

• System 

• System Interfaces 

• Address Translation 

• IP 

• ICMP 

• TCP 

• UDP 

• EGP. 

• Transmission 

• SNMP 

An SNMP agent can also send an unsolicited message (called a trap) containing 
information about, for example, the failure of a network resource. 
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GET, GET NEXT, GET_RESPONSE and TRAP are called protocol data units 
(PDUs). SNMP also defines a fifth PDU called SET, that is issued from an SNMP 
monitor to update data at an SNMP agent. 

SNMP also has a concept of subagents. A subagent is a separate program that 
communicates with an agent via a Distributed Program Interface (DPI) over a 
TCP connection. A subagent can REGISTER its own MIB objects and groups with 
an agent. The agent will then GET the information from the subagent, when an 
SNMP monitor requests it from the agent. A subagent can also generate traps, 
which the agent will forward to the SNMP monitor. This makes It possible to 
generate your own TRAPs by developing your own subagents with the SNMP 
DPI. 



16.2 Overview of the SNMP Implementation in OS/2 




Figure 227. SNMP Implementation in OS/2 
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The implementation of SNMP in OS/2 is shown in Figure 227. TCP/IP V2.0 for 
OS/2 implements the following SNMP functions: 

• An SNMP agent (SNMPD) that supports: 

— All currently defined MIB groups except the Exterior Gateway Protocol 
(EGP). 

— Two TRAPs: 

COLD_START {agent has reconfigured itself) 

AUTHENTICATION_FAILURE (a monitor request was not properly 
authenticated) 

Its own TRAPs can be implemented by developing subagents. 

— The protocol data units (PDUs) according to Figure 227 on page 294. 

Note: a set of SNPMD-owned MIB objects from an SNMP monitor is not 
supported. 

• The possibility of developing its own subagents with the SNMP DPI and 
connecting them via TCP to SNMPD. A subagent can run on the same OS/2 
machine as SNMPD or on a separate workstation. 

• Limited SNMP monitor functions SNMP GET/NEXT and SNMPGRP make it 
possible to retrieve MIB information from SNMPD running in a remote TCP/IP 
host. See Figure 227 on page 294. SNMPGRP can be regarded as a 
"remote" NETSTAT command. 

• A utility program, MAKE_PW, to provide scrambled passwords that SNMP 
monitors must use to contact SNMPD. 

The test environments for this chapter is shown in 1.4, “ITSC Raleigh Test 
Environments” on page 11. 



16.3 Setting Up the SNMP Agent (Server) in OS/2 

The OS/2 SNMP agent and utilities are contained in the Base Kit of TCP/IP V2.0 
for OS/2. Use the TCP/IP Configuration Notebook to set up the SNMP agent on 
your OS/2 system. The following screens describe the configuration pages: 
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Figure 228. TCPilP Configuration Notebook for SNMP, Page 1 



Setting 

SYSCONTACT 
SYSLOCATION 
MIB2.TBL File 



Meaning 

Name of the person responsible for that OS/2 workstation. 
Location of that OS/2 workstation 

A standard MIB table for the SNMP agent containing objects that 
belong to the various MIB groups that are defined for TCP/IP 
V2.0 for OS/2. You can add objects to this table, for instance for 
vendor logo products, that are not part of the standard MIB table 
as defined in RFC 1213. 

For a more detailed discussion about the MIB2.TBL file and how 
to add objects to the MIB, please refer to the TCP/IP V2.0 for 
OS/2 Installation and Maintenance and TCP/IP V2.0 for OS/2 
User's Guide. 
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Figure 229. TCP/IP Configuration Notebook for SNMP, Page 2 



Setting Meaning 

SNMPTRAP.DST Specify hosts where your SNMP agent shall send TRAPS. 
PW.SRC File Specify the SNMP communities and networks that you want to 
share MIB information with. 

Community Name Name for an SNMP Community 
Desired Network IP network base address 
SNMP Mask Subnet Mask for that IP network. 

These values allow an SNMP monitor to contact your SNMP 
agent. The IP address of an incoming request to SNMPD is 
logically ANDed with the SNMP mask and compared with the 
desired network. If they match, the password (or community 
name) is compared to the password in the incoming request. If 
that also matches, the request is accepted. 

In the above example, the PW.SRC file restricts access to 
SNMPD to SNMP monitors located on network 9.67.32.64, and 
the password must be either ITSC or public.. 

Note: The community names are case sensitive. 

The configuration will make changes to the following files: 

• \CONFIG.SYS 

• \TCPIP\ETC\SNMPTRAP.DST 

• \TCPIP\ETC\ PW.SRC 

and add the following environment variables to your CONFIG.SYS file: 

• SYSCONTACT 

• SYSLOCATION 

In addition to these variables, make sure that the variable HOSTNAME is set to 
the name of your host. 
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After leaving the Configuration Notebook, execute the MAKE_PW program. This 
program will read the PW.SRC file and create the scrambled file SNMP.PW. 
Copy SNMP.PW to the \TCPIP\ETC directory, or run MAKE_PW in that directory. 

To start the OS/2 SNMP agent and to enable the (limited) SNMP monitor, enter 

SNMPREQD 

SNMPD 

from an OS/2 command prompt. SNMPREQD must be started before SNMPD, 
because it keeps track of all incoming requests in order to correlate them with 
the responses. 



16.4 Network Management Utilities 

TCP/IP V2.0 for OS/2 contains a few basic utilities to monitor the TCP/IP network 
and provide information about local activity and remote hosts: 

16.4.1 SNMP and SNMPGRP 

The following shows an example of how to get information from the SNMPD 
agent running in the host martin by using the commands SNMP and SNMPGRP: 





OS/2 Ctrl +Esc = Task List Type HELP = help 

[C:\]snmp get martin ITSC syslocation 
Value of syslocation is DD 101 

[C:\]snmpgrp martin ITSC sys 

SYSTEM group 

Descr OS/2 SNMP AGENT version 1.2, with DPI version 1.1. 63 (Jun 2, 1993) 

Objectld 1.3. 6. 1.4. 1.2.2. 1.2. 2 

UpTime 1447462 

Contact Martin MURHAMMER 

Name martin 

Locati on DD 101 

Services 76 

[C:\]snmpgrp martin ITSC tcp 

TCP group 

RtoAlgorithm 4 
RtoMin 2000 
RtoMax 128000 
MaxConn 255 
ActiveOpens 16 
PassiveOpens 7 
AttemptFai 1 s 0 
EstabResets 18 
CurrEstab 1 
InSegs 7902 
OutSegs 7283 
RetransSegs 0 
InErr 0 
OutRsts 0 
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16.4.2 SNMPTRAP 

SNMPTRAP is a Presentation Manager application that receives, interprets and 
displays SNMP traps. The trap in the following sample was produced by 
restarting the SNMP agent on system martin: 




Figure 230. SNMPTRAP Showing a Trap 



16.4.3 PMPING 

PMPING periodically PINGs a number of hosts defined in a file called 
PINGHOST.LST. You can create that file manually, or use the TCP/IP 
Configuration Notebook (page 2 of the Services tag). The turnaround time, or a 
highlighted error indicator for each defined host is displayed. 




Results Displayed: Start 17:28:57 Stop 17:29:3 

Martin 

Scott 

CID 

RS/6000 

AS/400 

VM 

MVS 

X.2S 

DEC 

SUN 



Response in 
Response in 
Response in 
Response in 
NO RESPONSE 
Response in 
Response in 
Response in 
NO RESPONSE 
NO RESPONSE 



0 msec 
0 msec 
0 msec 
32 msec 
TO PING 
31 msec 
63 msec 
0 msec 
TO PING 
TO PING 



Figure 231. PMPING Showing Turnaround Times 

The PMPING application can be used to show the status of all important 
application servers or network routers. 



16.4.4 NETSTAT 

NETSTAT displays all available information about the local TCP/IP system. In 
case of communication problems it is a helpful tool for finding the cause. 
Especially the routing and ARP tables should be verified in case of problems. 
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[C:\tcpip\tmp3netstat -a 

addr 9.67.38.81 interface 8 mask ffffffcB broadcast 9.67.38.127 

[C:\tcpip\tmpjnetstat -s 



SOCK 


TYPE 


FOREIGN 


LOCAL 


FOREIGN 


STATE 






PORT 


PORT 


HOST 




1056 


DGRAM 


0 


0 


0.0,0. 0 


UDP 


1309 


STREAM 


6000 


1028 


9.67.38.81 


CLOSE WAIT 


81 


STREAM 


0 


1024 


0.0. 0.0 


LISTEN 


80 


DGRAM 


0 


161 


0.0. 0.0 


UDP 


79 


DGRAM 


0 


1024 


0.0. 0.0 


UDP 


78 


DGRAM 


0 


0 


0.0. 0.0 


UDP 


10 


STREAM 


0 


139 


0.0. 0.0 


LISTEN 


9 


DGRAM 


0 


138 


0.0. 0.0 


UDP 


8 


DGRAM 


0 


137 


0.0. 0.0 


UDP 



[C:\tcpip\tmp]netstat -n 
Interface 8: 882.5 

physical address 488888832248 MTU 1588 

speed 4888666 bits/sec 

unicast packets received 11294 

broadcast packets received 3537 

total bytes received 2276412 

unicast packets sent 18676 

broadcast packets sent 11 

total bytes sent 1252732 

packets discarded on transmission 8 

packets discarded on reception 8 

received packets in error 8 

errors trying to send 8 

packets received in unsupported protocols 6 

[C:\tcpip\tmp] 



The example shows how to use the netstat command to: 

• Obtain information about locally used IP addresses (-a option) 

• Obtain information about local application activity showing active sockets, 
ports, local and remote addresses, and status {-s option) 

• Obtain information about the local hardware interfaces assigned to IP (-n 
option). 



16.4.5 ARP 

The ARP table is used to map IP addresses and physical addresses on a LAN. It 
is dynamically built by the Address Resolution Protocol (ARP) provided by 
TCP/IP. To reduce network overhead, the entries are kept in memory. If the 
entry is not used during a certain time period, it will be deleted. Sometimes it is 
desirable to delete an entry manually, or to refresh the whole ARP table. That 
can be done with the ARP command: 
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— 
[C:\]arp - 


a 

ARP table contents: 






N 


interface 


hardware address 


IP address 


minutes since 
last use 




6 


10665a4f58ce 


9.67.38.73 


4 




e 


10005ac93f63 


9.67.38.74 


4 




6 


400040010003 


9.67.38.115 


17 




e 


10005aa87023 


9.67.38.72 


4 




0 

^ [C*\] 


10005ac95035 


9.67.38.67 


0 


J 



The example shows all entries in the ARP table on system martin. The 
command arp -f deletes all entries. If you then PING any system, it will cause 
an ARP request first. This can be useful for tracing and debugging purposes. 



16.4.6 RPCINFO 



This command reports the status and services registered to RPC {Remote 
Procedure Call) on remote systems. This is especially useful if you want to use 
an RPC-based application such as NFS, and you want to ensure that 
communication with a remote host will not result in an error: 



[C:\]rpcinfo -p mvs!8sna 



program 


vers proto 


port 




100000 


2 


udp 


111 


portmapper 


100000 


2 


tcp 


111 


portmapper 


100059 


1 


udp 


1026 




100044 


1 


udp 


1029 




100005 


1 


udp 


1032 


mountd 


150001 


1 


udp 


1035 


pcnfsd 


150001 


2 


udp 


1038 


pcnfsd 


100003 


2 


udp 


2049 


nfs 



[C:\] 



The example shows RPC status information obtained from an MVS TCP/IP host. 



16.5 Managing OS/2 TCP/IP Hosts using NetView/6000 

NetView/6000 is a network management application based on SNMP. It fully 
implements an SNMP monitor with the capability to send SNMP GET, GET_NEXT 
and SET commands to SNMP agents on a TCP/IP network. 

The following figure shows an OS/2 TCP/IP host running NetView/6000 Entry from 
an AIX system. It uses PMX, the OS/2 X Window System Server, since 
NetView/6000 is implemented as an X Client application. The window shows the 
MIB browser utility to view or change values of a system's MIB: 
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Figure 232 . Managing an OS/2 MIB With NetView/6000 from an OS/2 TCP//P System 



16.6 Establishing an IP Router with OS/2 

Routing is the process of deciding where to send an IP packet based on its 
destination address. There are two types of routing involved in communication 
within an Internet: 

Direct Routing The source and destination hosts are on the same (logical) 

IP network. 
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Indirect Routing The source and destination hosts are on different (logical) 
IP networks. In this case, IP packets are sent to a router 
on the local network using direct routing. The router, 
which is connected to the local and one or several remote 
networks, then forwards the packets to their destination, 
eventually involving more intermediate gateways on the 
way. 

Note: Router and Gateway refer to the same function or type of host as far as a 
TCP/IP network is concerned. 



Indirect routing must be employed when a connection needs to be established 
across different physical media. 

TCP/IP V2.0 for OS/2 supports both direct and indirect routing. The process of 
determining which type of routing to perform is as follows: 

1. A TCP/IP application issues a communication request indicating a 
destination IP address that it wants to connect to 

2. A logical AND is performed with that destination IP address and the local 
subnet mask; the outcome is an IP network base address 

3. A logical AND is performed with the local IP address and the local subnet 
mask; if the outcome matches the one above, the IP packets will be sent on 
the local network using direct routing. 

4. If the two results do not match, the IP packets will be sent to a router on the 
local network and then forwarded using indirect routing. 



The following example shows how host martin finds out that it can reach host 
cidserver on his local IP network, but must use a router to reach host mvs18sna: 

host IP address subnet mask 



martin 9.67.38.81 
cidserver 9.67.38.115 
mvslSsna 9.67.38.135 



255.255.255.192 

255.255.255.192 

255.255.255.192 



performing logical ANDs using binary representation of IP addresses: 



a) martin's local IP address and subnet mask: 

9 .67 .38 .81 

6888 1681 . 8166 8811 . 8818 6118 . 6181 6801 

AND 

255 . 255 . 255 . 192 

1111 1111 . 1111 1111 . 1111 1111 . 1188 6886 



6868 1881 . 8168 8811 . 6616 8118 . 81 

9 . 67 . 38 . 64 

Note: Only the bits set to 1 in the subnet mask are significant. 

b) cidserver's IP address and martin's subnet mask: 

9 .67 .38 . 115 

6668 1861 . 8188 6811 . 8616 8116 . 8111 6811 

AND 

255 . 255 . 255 . 192 

ini ini . mi mi . ini nil . neo 6866 
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0008 1001 . 0100 0011 . 0010 0110 . 01 

9 .67 .38 .64 

This matches the result of a); direct routing is used. 

c) mvslSsna's IP address and martin's subnet mask: 

9 .67 .38 . 135 

0000 1001 . 0100 0011 . 0010 0110 . 1000 0101 

AND 

255 . 255 . 255 . 192 

mi mi . mi mi . ini nil . 1100 0000 



0000 1001 . 0100 0011 . 0010 0110 . 10 

9 . 67 .38 . 128 

This is different from the result of a); a router must be used. 

There are several ways to find a router for a specific network: 

1. Add a statement to the local routing table for each network that you want to 
reach (static routing) 

2. Define a default router (static or dynamic routing) 

3. Run ROUTED daemon (dynamic routing). 

The local routing table is built at the time you initialize an interface for TCP/IP 
using the IFCONFIG command. By performing logical AND operations with the IP 
address and subnet mask for each active interface on your system. TCP/IP 
determines an IP network base address. On all networks that have been 
determined by that process, direct routing can be used. 

To display your local routing table, use the NETSTAT command with the -r 
option: 



[C:\tcpip\tmp]netstat -r 



destination 


router 


refcnt 


use flags 


snmp 

metric 


intrf 


9.67.38.128 


9.67.38.65 


0 


0 


U 


-1 


1an0 


9.67.32.64 


9.67.38.75 


0 


0 


U 


-1 


lan0 


9.67.38.64 


9.67.38.81 


2 


17046 


U 


-1 


lan0 


9.67.212.0 


9.67.38.90 


0 


0 


U 


-1 


lan0 


9.67.38.0 


9.67.38.90 


0 


0 


U 


-1 


lan0 



16.6.1 Static Routing using ROUTE 

To use static routing, you must build a routing table on your system by using the 
ROUTE command. You can add static routes using the TCP/IP Configuration 
Notebook (Routing page). There are four types of static routes that you can set 
up: 

Net Use this option if you want to set up a route between two different 

internets (between IP networks of the same class or between different 
classes of IP networks). 

route add net 192.9.3.0 9.24.97.1 5 
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In this example, the network 192.9.3 (class C) can be reached through 
router 9.24.97.1 (class A), and there are five gateways between the 
local and the destination network (five hops). If there were more than 
five hops, your IP packages would be discarded by the sixth gateway. 
The maximum number of hops is 15. 

Subnet Use this option if you want to set up a route between subnets within 
the same IP network. 

route add subnet 9.67.38.128 9.67.38.65 1 

In this example, the network 9.67.38.128 can be reached through 
router 9.67.38.65, and it is one hop away (one router in between). 
These two networks can be formed using a subnet mask of 
255.255.255.192. 

Host Use this option if you want to set up a route to a specific host. You 
can use this option on a point-to-point link, or if you need to override 
an existing net or subnet route (should normally not be the case). 

Default Use this option if you do not know how to reach remote networks, or 
if you want all indirect routing to occur through the same gateway. 

route add default 9.67.38.65 15 

This example sets up a default router for all destination networks 
except 9.67.38.64 (the local network with a subnet mask of 
255.255.255.192). 

In the last case, the designated router may employ either static or dynamic 
routing, but it doesn't matter. 

16.6.2 Dynamic Routing using ROUTED 

When you want to use dynamic routing, you must use the ROUTED daemon. It 
runs as a separate OS/2 task and can be shut down with the Ctrl-C key 
combination. 

ROUTED uses the Route Information Protocol (RIP) to exchange its local routing 
table with other hosts running ROUTED. Thus, it will eventually learn about the 
whole network and how to reach each part of it. ROUTED runs on every local 
interface that has been initialized for TCP/IP. 

Since RIP communicates its routing table every 30 seconds, you may create 
additional network traffic just for exchanging routing information. This is 
desirable since it makes routing transparent to the applications and users, but it 
may cause capacity problems on some connections, especially across wide area 
networks or serial links. 

In this case, either use static routing, or start ROUTED with the -q option; that 
will prevent it from forwarding its own routing table though it may learn about 
others (unless they also use the -q option). 

In order to tell ROUTED about routes that it cannot reach directly, you can use a 
GATEWAYS file. That file will take the following entries: 

• Type of route (net, host) 

• Network address 

• Gateway name or address 

• Number of hops to that destination 

• Type of gateway (active, passive, external). 
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ROUTED will consider an active gateway one which will communicate its 
routing tables, whereas a passive gateway would not do that (like ROUTED -q). 
An external gateway will be considered one that uses a routing protocol 
other than RIP. 

16.6.3 Routing on the Local Network using a Dummy Router 

Whenever you need to communicate with a host that is using an IP address on a 
different Internet, there must be router in between. Since IP networks are logical 
networks, addresses from several IP networks can be used on the same 
medium, most likely a LAN. In order to establish routing between these IP 
networks, you can: 

1. Set up a workstation with more than one interface and make it a static or 
dynamic router 

2. Use an unassigned IP address and make it a dummy router for the other IP 
networks. 

An example for case 2, using static routes, would look as follows: 
route add subnet 9.24,97.0 9.67.38.99 0 

In this case, a workstation on IP network 9.67.38.64 

1. Wants to communicate to IP network 9.24.97 

2. Uses 9.67.38.99 as a router 

3. Specifies a hop count of 0 which indicates that IP packets must be 
transferred using direct routing on the local (physical) network. 

A host on IP network 9.24.97 must have a corresponding statement in order to 
enable communication: 

route add subnet 9.67.38.64 9.24.38.2 0 
Notes: 

1. Use this scenario only if you have no other possibility to establish a router. 

2. Make sure that all workstations that need to communicate with other IP 
networks on the same physical network use the proper route statement. 

3. Make sure that the hop count is set to 0 in every route statement used for a 
dummy router. 

4. Make sure that the addresses specified for the dummy routers are not used 
by real machines. 



16.7 BOOTstrap Protocol 

The BOOTP protocol enables a client to get its IP address, a gateway address 
and the address of a name server from a BOOTP server machine. You can use 
it to update your network relevant information from a central point, the BOOTP 
server. You can use it on a token-ring network with token-ring bridges, which 
use the Source-Routing protocol. It does not work with the token-ring to Ethernet 
bridge (IBM 8209). 

Note: The BOOTP server and the BOOTP client have to be on the same physical 
token-ring LAN or Ethernet segment. It is not possible to run BOOTP over SLIP 
or X.25 interface. 
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The BOOTP server must have a BOOTPTAB file, which is a correspondence file 
for hardware addresses and IP addresses. A sample BOOTPTAB file is included 
in the \TCPIP\ETC directory. You must change this file to contain hardware 
addresses, IP addresses, gateway addresses, and name server addresses for 
your local network. 

To find the hardware addresses of the installed terminals, use the NETSTAT 
command with the -n parameter, on the installed terminal. 

You must verify that the SERVICES file in the \TCPIP\ETC directory contains the 
following two lines: 

sbootp 67/udp #bootp server 
cbootp 68/udp #bootp client 

These statements have to be in both machines, the server and the client. 

The following BOOTPTAB file is the example of the configuration with host 
cidserver as the BOOTP server: 

# \tcpip\etc\bootptab: database for bootp server BOOTPD 

# Blank lines and lines beginning with are ignored, 
if 

if Legend: 

# first field — hostname 

# (full domain name) 

# 

# bf — bootfile (not supported) 

# ds -- domain name server address list 

# gw -- gateway address list 

# ha — host hardware address (follows ht) (hexadecimal) 

# hd — home directory (not supported) 

# hn — send host name (boolean tag) 

# ht — host hardware type (precedes ha) (Ethernet, ether) 

# ip — host IP address 

# sm — subnet mask 

# tc — template host (points to similar host entry) 

# 

# Be careful about including backslashes where they're needed. 

# Strange things can happen when a backslash is 

# omitted where one is intended. 

# 



# First, we define a global entry which specifies the info every 

# host uses. 

global . dummy :\ 

:sm=255.255.255.192:\ 

: hd=/bootpd/trypd : bf=nul 1 :\ 

: ds=9 . 67 .38.115: 

# Next, the subnets default route information. 

subnet38. dummy :\ 

:tc=global .dummy:gw=9. 67. 38.69 

subnet32. dummy :\ 
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:tc=global .dunmy:gw=9. 67. 32.68 



# Last, the Individual information. 

ci dserver . i tsc. ral ei gh . i bm. com: tc=subnet38 . dummy: ht=ethernet :\ 
ha=4008400 10O03: ip=9. 67. 38.115: hn: 
dos20.itsc.raleigh.ibm.com: tc=subnet38. dummy: ht=ethernet:\ 
ha-10005a26399c: ip=9. 67. 38.68: hn: 
os25.itsc.raleigh.ibm.com: tc=subnet38. dummy: ht=ethernet:\ 
ha=400030010002: ip=9. 67. 38.69: hn: 
os25e.itsc.raleigh.ibm.com: tc=subnet32. dummy: ht=ethernet:\ 
ha=10005a8258de: ip-9.67.32.68: hn: 

Note: The ht= (host hardware type) parameter must be either ETHERNET or 
ETHER, even if the physical connection is token-ring. The hn parameter 
for the host name to send must be blank. Every input to the BOOTPTAB 
file is sensitive to the syntax. To create your own BOOTPTAB file rename 
the original sample BOOTPTAB to, for example, BOOTPTAB.ORI, and 
copy this file to BOOTPTAB. Do not erase the original BOOTPTAB file. 

A successfully started BOOTP process will show you the following screen on the 
OS/2 BOOTP client os25: 



[C:\]bootp 

ifconfig lan9 9.67.38.69 netmask 255.255.255.192 

route add default 9.67.38.69 1 

add net default: router 9.67.38.69: File exists 

Name server: 9.67.38.115 

Host name os25.itsc.raleigh.1bm.com 



The next screen shows the BOOTP request from OS/2 BOOTP client os25 and 
DOS BOOTP client dos20 in the BOOTPD window of host cidserver: 



[C:\]bootpd -d -d -d -d -d 

bootpd: reading “D:\TCPIP\ETC\BOOTPTAB" 
bootpd: read 7 entries from "D:\TCPIP\ETC\BOOTPTAB" 
bootpd: request from hardware address 408030810802 
bootpd: vendor magic field is 99.130.83.99 
bootpd: sending RFC1048-style reply 
bootpd: request from hardware address 10885A26399C 
bootpd: vendor magic field is 99.130.83.99 
bootpd: sending RFC1048-sty1e reply 

/ 



You can start an OS/2 BOOTP client without TCP/IP V2.0 for OS/2 started, but 
after an unsuccessful BOOTP you should run at least the SETUP.CMD to set the 
network interfaces to a legal status. Each interrupted BOOTP process can result 
in unpredictable errors if the machine is not rebooted or the SETUP.CMD not 
run. 
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16.7.1 BOOTP from a DOS Workstation 

The BOOTP client allows a client machine to discover its own Internet address, 
subnet mask, default router, host name, domain name, domain name servers, 
print and time server from a remote BOOTP protocol server. The following is the 
format of the BOOTP command: 

BOOTP [-? -?? | <hware_name>] 

where: 

-? displays a list of parameters and their meaning. 

-?? displays a more detailed list of parameters 

<hware_name> is the name interface defined by CUSTOM that is 
to be set by the execution of BOOTP. 

To use BOOTP, your PC must be configured as follows: 

1. Verify that a BOOTP server is running on the network. 

2. Use CUSTOM to create an interface, for example, ndO, enter any valid 
Internet address in the IP Address field, for example 1.1. 1.1 - (note that this 
will be replaced once you execute BOOTP) and leave the Network Mask field 
blank. 

To execute BOOTP, you must enable TCP/IP for DOS with the TCPSTART 
command. Once TCP/IP for DOS is enabled, you can then execute BOOTP. 

The following is an example of the response that is displayed as a result of 
issuing the command BOOTP ndO to an OS/2 BOOTP server: 



. 

C:\>bootp nd9 

ifconfig ndO 9.67.38.68 netmask 255.255.255.192 
route add default 9.67.38.69 

writing to the route daemon; No space left on device 

add net default: gateway 9.67.38.69: No space left on device 

Name server: 9.67.38.115 

Host name dos20.itsc.ra1eigh.ibm.com 



The OS/2 BOOTP server only sends the data which was defined in the 
BOOTPTAB file. 

You can run the TCP/IP for DOS BOOTP client to an OS/2 BOOTP server as long 
as you are on the same physical LAN segment as the BOOTP server. It does not 
run on a SLIP connection. There is only the request for the data at the BOOTP 
server, but no response to the BOOTP client. To start the BOOTP client on DOS, 
TCP/IP has to be already initialized. 
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Chapter 17. Problem Determination 



This section lists the utilities provided with TCP/IP V2.0 for OS/2 that help you 
find out what is going wrong in case of communication problems. Please note 
that this is only a brief overview of what you can do, since thorough problem 
analysis and tracing would go far beyond the scope of this document. For a 
more detailed discussion of problem determination in a TCP/IP environment, 
please refer to the TCP/IP for MVS, VM, OS/2 and DOS Troubleshooting Guide, 
GG24-3852. 



17.1 Overview 

The following list describes the utilities that you will need most to find the reason 

of a communications problem: 

Program Description 

PING Sends an ICMP message to a destination IP address or IP 

network and reports the response time if that destination can be 
reached. By default, PING sends a 56 byte message 
continuously until you terminate it with Ctrl-C. You can also 
specify a number of packages to be sent in order not to cause 
too much network traffic or keeping routers busy. Use this 
command to determine whether you can reach a destination on 
an IP network. 

NETSTAT NETSTAT helps you obtaining information about your own IP 
interfaces. In most cases you will need the following: 

• List IP addresses in use at your workstation 
netstat -a 

• List TCP/IP routing tables in use at your workstation 
netstat -r 

• List connections of TCP/IP clients and servers at your 
workstation 

netstat -s 

• Show characteristics of IP interfaces at your workstations 
netstat -n 

• List the ARP table in use at your workstation 
netstat -p 

• Show the status of TCP at your workstation 
netstat -t 

• Show the status of UDP at your workstation 
netstat -u 

• Show the status of IP at your workstation 
netstat -i 

• Show the status of ICMP at your workstation 
netstat -c 
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In case a connection cannot be established, use NETSTAT to 
find the cause of the problem. 

IFCONFIG Initializes an IP interface at your workstation and allows you to 
query its status. This is helpful if you have to find out if an IP 
interface is active (UP). 

ARP Displays the IP-to-hardware address mapping table at your 

workstation. You can manually add a hardware address to your 
ARP table, for instance if you lose connection to a router. 

Note: Be careful when updating the ARP table. Entering a 
wrong IP-to-hardware address pair will result in 
communication errors. 



17.2 Problem Case 

The steps provided in this section should be used as a guide. We recommend 
that you follow these steps when you are unsuccessful in your attempts to use 
one of the services provided in TCP/IP V2.0 for OS/2. 

1. Determine if your interface to the network is up by running this command: 
ifconfig link 

Where link is the name of the interface that you are trying to use to access 
the network. It must be one of the following: 

Interface Description 

ianOto Ian7 LAN interfaces (Token-Ring, Ethernet, PC Network, 3174 Peer 
LAN over Coax, FDDI, Frame Relay, 3172 Offload) 
slO SLIP interface 

x25 X.25 interface 

snal SNALINK interface 

snaO Sockets over SNA interface provided by the AnyNet/2 program. 

This is the result of this command when used to check the status of the 
interface of a token-ring adapter on a machine that was working OK. 



\ 

[C:\tcp1p\bin]ifconf1g lan0 

lan0: flags-3063<UP, BROADCAST, NOTRAILERS, RUNNING, BRIDGE, SNAP> 
inet 9.67.38.106 netmask ffffffcO broadcast 9. 67. 38. 127 
J 



You will notice that the link is UP, and it shows all information associated 
with that interface. 

This is the result of this command when used it to check the status of the 
interface LAN1, which is not physically installed on the machine. 



\ 

[Cs \tcp1 p\b1 n]1 fconf 1g lanl 

lanl: f 1 ags**3032<BRQADCA$T , P0INT0P0 I NT , NOTRAILERS , BRIDGE, SNAP> 
loctl (S IOCGIFADDR) : Can't assign requested address 

inet 0.0. 0.0 loctl (SI0C6I FNETMASK) : Can't assign requested address 
ioctl (SIOCGIFDSTADDR) : Can't assign requested address 
— > 0.0. 0.0 netmask 0 ioctl (S IOCGIFADDR) : Can't assign requested address 

v __ > 



You will notice that command fails and clearly illustrates that the interface is 
not operational. 

If your interface is not functioning correctly then you should make sure that 
you have run C:\TCPIP\BIN\SETUP.CMD and configured your interface 
information correctly in the TCP/IP Configuration Notebook. 
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2. Determine if your physical connection to the network is functioning by using 
this command: 

PING IP-address 

Where IP-address is the IP address of an active host. 



a. If you cannot PING your own address that does not necessarily mean 
that your network connection is down since your PING to yourself might 
not at all go out to the network. If it is unsuccessful, the reason might be 
that the TCP/IP protocol stack has not been initialized at your 
workstation. 

b. You cannot PING yourself on a SLIP connection (loop-back not 
supported). 

c. You can only PING yourself on an X.25 or SNALINK connection if both 
sides of the link are up. 

This is the result of a successful attempt to PING a destination address: 



s 

[C:\tcp1p\b1n]p1ng 9.67.38.75 18 5 
PING 9.67.38.75: 18 data bytes 
18 bytes from 9.67.38.75: 1cmp_seq-0. time-31, ms 
18 bytes from 9.67.38.75: 1anp_seq*l. time-8. ms 
18 bytes from 9.67.38.75: 1cmp_seq-2. time-8, ms 
18 bytes from 9.67.38.75: 1cmp_seq-3. time-8, ms 
18 bytes from 9.67.38.75: 1cmp_seq-4. time-8, ms 

9.67.38.75 PING Statistics 

5 packets transmitted, 5 packets received, 8% packet loss 
round-trip (ms) mln/avg/max ■ 8/6/31 

/ 



This is the result of an unsuccessful attempt to PING the destination address: 



— 
[C:\tcp1p\b1n]p1ng 9.67.38.75 18 5 
PING 9.67.38.75: 18 data bytes 

9.67.38.75 PING Statistics 

5 packets transmitted, 8 packets received, 188% packet loss 
__ J 



If you cannot PING the destination IP address, then you should ensure that: 

a. The machine with the destination address is functioning correctly 

b. You are on the same IP network or subnet, or your router can access the 
destination IP address 

c. There are no physical network problems. 

3. Determine if you can reach a router for the desired destination using PING. 

If that is unsuccessful and you are sure that the router itself is working, use: 

[C:\]ARP -a 

ARP table contents: 

interface hardware address IP address minutes since 

last use 

0 400040600001 9.67.38.115 3 



to find out whether the router's hardware address is in your ARP table. If 
not, you can manually add it using the following command: 

arp -s hostname hardware_address 



Chapter 17. Problem Determination 313 






4. Find out if a server is running at your workstation if someone else cannot 
communicate with it, but PING, ARP, and IFCONFIG do not indicate an error 
condition. Enter the following command to see TCP and UDP activity at your 
workstation: 



[c:\]netstat -s 
SOCK TYPE 


FOREIGN 

PORT 


LOCAL 

PORT 


FOREIGN 

HOST 


STATE 


15 


STREAM 


1024 


telnet. .23 


9.67.38.81 


ESTABLISHED 


14 


STREAM 


telnet.. 23 


1024 


9.67.38.81 


ESTABLISHED 


12 


STREAM 


1024 


telnet. .23 


9.67.38.106 


ESTABLISHED 


11 


STREAM 


0 


shell.. 514 


0.0. 0.0 


LISTEN 


16 


STREAM 


0 


exec.. 512 


0.0. 0.0 


LISTEN 


9 


STREAM 


0 


ftp.. 21 


0.0. 0.0 


LISTEN 


8 


STREAM 


0 


tel net.. 23 


0.0. 0.0 


LISTEN 



This will show you the sockets in use, the type of connection, the foreign and 
local ports, the addresses of the foreign hosts that are connected, and the 
state of the connection. A state of LISTEN refers to a server at your 
workstation. The port assignments can be found in the 
\TCPIP\BIN\SERVICES file. 



17.3 Trace Utilities 

The following facilities are provided with TCP/IP V2.0 for OS/2 to do tracing: 
Program Description 

TRACERTE This command helps you find the route that a connection 

to a destination will or will not take. 

TRACERTE IP-address 

This is the result of a successful attempt to access a 
remote destination address: 



\ 

[C:\tcp1p\bln]tracerte 9.67.22.1 

tracercute to 9.67.22.1 (9.67.22.1), 38 heps sax, 33 byte packets 
8 6611ral (9.24.97.1) 8 as 15 ns 0 ns 

1 66ilra1 (9.24.97.1) 32 ns 8 ns 31 ns 

2 rtcoqt.sl.dfw.ibn.coa (9.24.1.1) 62 as 62 as 63 ns 

3 dsl-wlk.dfw.lbn.con (9.19.141.241) 63 ns 71 ns 62 ns 

5 * - - 

6 192. 156. 219.18 (192.156.219.18) 156 ns 187 ns 188 as 

7 ralvca.roleigh.lba.coa (9.67.22.1) 188 ns 219 ns 107 as 

V __ J 



This is the result of an unsuccessful attempt to access a 
remote destination address: 
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TRACERTE will constantly increase the time-to-live value of 
the packages sent, and it will stop after 30 attempts. 

Note: A route to a destination may still exist (you can 
PING the remote address) though TRACERTE 
cannot track it. The reason may be that the 
response time of some routers is longer than it 
takes TRACERTE to finish. 

IPTRACE This program will trace IP activity. It creates a file called 

IPTRACE.DMP. 

IPPARSE Translates output from the IPTRACE.EXE program into a 

Sniffer format. 



This is an example of the output from the IPPARSE 
program: 




Several of the TCP/IP servers and clients that come with TCP/IP V2.0 for OS/2 
also provide some tracing or logging capability: 

• BOOTPD 

• NAMED 

• NetBIOS/2 

• NSLOOKUP 

• PMX 

• ROUTED 

• SNMP 

• SNMPD 

• TELNETD 
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• Telnet Client 

See the TCP/IP V2.0 for OS/2 Command Reference for the syntax of these 
commands, and how to enable tracing or logging. 

When you are using an X.25 or SNALINK connection, you can also do tracing 
from within Communications Manager. 
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Chapter 18. Application Programming Interfaces 



This chapter refers to the application programming interfaces provided with 
TCP/IP V2.0 for OS/2 and the Programming Kit. 



18.1 Overview 



TCP/IP V2.0 for OS/2 contains the following application programming interfaces 
(APIs) that can be used to write network applications in the C programming 
language: 

• BSD Sockets 

• Sun Remote Procedure Call (RPC) 

• FTP 

• SNMP DPI 

• X Window System Client (XII) 

The XII APIs are provided by the X Window System Client Kit, all other APIs are 
provided by the Programming Kit. See Chapter 12, “X Window System Client 
and OSF/Motif Kits” on page 213 for more information about the X Window 
System Client APIs. These kits provide the following files to support developing 
applications: 

• Header and Include files 

• Link time libraries 

• Dynamic link libraries 

• Sample programs 



18.2 System Requirements and Installation 

In order to develop applications using the APIs provided for TCP/IP V2.0 for 
OS/2, you need to have the following installed on your workstation: 

1. OS/2 2.0 or higher 

2. TCP/IP V2.0 for OS/2 Base Kit 

3. TCP/IP V2.0 for OS/2 Programming Kit 

4. IBM C Set/2 

You can install the Programming Kit either in addition to the Base Kit, or later on 
as a separate component. In that case, insert the Programming Kit diskette into 
drive A: and enter: 

A:TCPINST 

You can likewise install the Programming Kit from a remote drive, using, for 
instance, the remote installation method provided with TCP/IP V2.0 for OS/2, or 
IBM OS/2 LAN Server V3.0. 

The installation program will put the necessary files in the following directories 
and subdirectory thereof: 
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Table 19. Directories for the Programming Kit Files 



API Files 


Directory 


Header and Include Files 


\TCPIP\INCLUDE 


Link Time Libraries 


\TCPIP\LIB 


Dynamic Link Libraries 


\TCPIP\DLL 


Sample Program Code 


\TCPIP\SAMPLES 



Please see the IBM C Set/2 User's Guide for information on how to set up your 
environment variables, compiler switches, and linker options. 



18.3 Multi Thread and DLL Support 

TCP/IP V2.0 for OS/2 supports multi-threaded and Dynamic Link Libraries (DLL) 
for all of the APIs. This allows writing TCP/IP applications that execute multiple 
threads. Each thread runs as independent code, but shares the same resources. 
A Presentation Manager application that issues communication requests should 
do this in a separate thread, because a short turnaround time for the request is 
not guaranteed. If the network is very slow or congested, it takes a long time for 
the request to complete. During this time, the whole Presentation Manager is 
blocked while it is waiting for the network request to complete. 

A real server that uses the socket APIs is another example for the multitasking 
need. It should be able to communicate with many clients at the same time. 

This requires multiple threads in an OS/2 environment. 



Client 1 




Figure 233. Multitasking Server 

In the figure above, the server consists of a control thread that waits for 
incoming requests from any client and creates a new thread that actually 
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handles the I/O and the processing. This allows communication with several 
clients simultaneously. 

The DLL libraries offer additional advantages. The functions in the DLL libraries 
are used only at run time. They are linked dynamically when a program runs, 
instead of at link time. Applications that use DLLs need less run time memory 
and also need less user disk space. If a DLL is needed by multiple applications, 
it is loaded only once and shared by all applications simultaneously. 

For more information about DLLs, please refer to the OS/2 Technical Library 
Application Design Guide, S10G-6260. 

18.3.1 Socket API 

A socket is a communication endpoint (uniquely identified by host IP address 
and a port number), that a TCP/IP application uses to communicate with another 
TCP/IP application (on the same host or on a different host). Sockets are duplex, 
which means that data can be transmitted and received simultaneously. 

The TCP/IP for OS/2 Socket API interfaces to the TCP. UDP, ICMP and IP 
protocols are implemented in INET. 

TCP/IP supports three socket types: 

1. Stream socket 

2. Datagram socket 

3. Raw socket 

Stream sockets transmit data reliably in both directions between two 
applications by using the TCP protocol. FTP is implemented with stream 
sockets. 

Datagram sockets are connectionless. Data is sent in both directions without 
any guarantees using UDP. Data may be lost or duplicated and datagrams may 
arrive out of order. The size of a datagram is limited to 2KB. NFS is built on 
datagram sockets. 

Raw sockets interface to the ICMP and IP protocols. PING uses raw sockets. 

18.3.2 Remote Procedure Call APIs (Sun RPC) 

The Remote Procedure Call (RPC) API is a higher level and more powerful 
interface than the Socket API. It is built on top of sockets and is used to develop 
distributed or cooperative processing client/server applications. RPC extends 
the procedure mechanism in a program to allow procedures to be distributed in 
the network. The idea is that a remote procedure call should look the same to 
the programmer as the usual local procedure call. The programmer should not 
be concerned with network details like sockets and addressing and therefore can 
be more productive. 
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Figure 234. The RPC Mechanism 

When The RPC client program issues a remote procedure call, it actually calls a 
local stub procedure (See Figure 234). 

The client stub packages the parameters in a standard format understood by the 
server stub, builds request packets and transfers them over the network. The 
server stub receives the packets, calls a dispatch routine that services the call, 
builds a response packet and transfers it back to the client stub. The client stub 
converts any return values to the RPC client's native format and returns them to 
the RPC client. 

TCP/IP V2.0 for OS/2 provides an RPC interface based on Sun Microsystem's 
RPC Library (Sun RPC). Currently the Sun RPC is also implemented in IBM's 
AIX, VM and MVS systems. 

Data Representation: Sun RPC defines an intermediate data representation 
protocol called External Data Representation (XDR) to account for architectural 
differences in data representation between a server and a client. XDR is always 
used, even if the server and client use the same computer architecture. 

Interface Language: The Sun RPC defines the RPC Language (RPCL) to 
describe the remote procedure characteristics. RPCL allows remote procedures 
to have only one parameter. When more than one parameter is needed, they 
must be packaged in a structure and XDR procedures must be written to 
marshall and unmarshall the parameters. The RPCL definition is compiled with 
the RPCGEN tool, which generates C source code for the client and server stubs. 

Transport Protocol: Sun RPC uses either TCP or UDP. If UDP is used, there is a 
current limit of 2KB that can be sent at one time and there is no guarantee that 
the remote procedure will be executed only once. 
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Binding and Port Location: The location of an RPC server must be known by the 
client program or supplied by the user to the program. When an RPC server 
starts, it registers itself {by supplying its port number) with a local program 
called Portmapper. A remote client program can obtain the server's port 
number by contacting Portmapper on the server's host via a well-known port. 

The following components make up the Sun RPC Support provided by TCP/IP 
V2.0 for OS/2: 

• RPC Library 

• RPCGEN 

• PORTMAPPER 

• RPCINFO 

18.3.3 File Transfer Protocol API 

This API allows an application to use the File Transfer Protocol (FTP) to 
communicate with an FTP server. It allows up to 256 simultaneous connections 
and supports proxy transfers. An example of such an application is FTPPM. 

The following functions are supported through the FTP API: 



Table 20. FTP Functions Supported Through FTP API 



dir 


Is 


cd 


pwd 


mkd 


rmd 


rename 


delete 


put 


get 


append 


putunique 


proxy 


site 


logoff 


quote 


ping 


sys 







18.3.4 SNMP DPI 

The SNMP implementation and the role of the SNMP DPI is described in 
Chapter 16, “Network Management and Interconnection” on page 293. 

The SNMP DPI API provides the necessary files for writing your own SNMP 
subagents. An SNMP subagent can dynamically support its own network 
management variables and generate its own alerts to a SNMP monitor. It can 
ADD, DELETE, or REPLACE MIB values, and generate SNMP TRAPs. Supported are 
DPI VI. 1 and RFC 1228 interfaces. 



18.4 API Programming 

All APIs must be compiled and linked using the IBM C Set/2 Compiler. Sample 
C source code for compiling and linking are supplied with the Programming Kit 
of TCP/I PV2.0 for OS/2. 

Detailed information on how to compile, link and run these sample programs is 
provided in the IBM TCP/IP V2.0 for OS/2 Programmer's Reference, and in the 
IBM C Set/2 User's Guide. 
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Chapter 19. AnyNet/2 and OSF/DCE for OS/2 



This chapter describes the installation and customization of AnyNet/2 and gives 
you a brief description of OSF/DCE. 

AnyNet/2 is a separately available program that implements the Common 
Transport Semantics (CTS) layer under OS/2, according to the IBM Networking 
Blueprint which is shown in the following figure: 
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Figure 235. IBM Networking Blueprint 

CTS allows applications to communicate across a network regardless of the 
underlying protocol stacks. It divides the protocol stacks at the Transport layer 
{layer 4). To an application, CTS provides the functions of a transport network as 
expected by that application. To a transport network, CTS provides the functions 
and protocols as required for that transport network. CTS includes the following 
situations: 

1. Application protocol matches transport network protocol 

2. Defined industry standards (for example NetBIOS over TCP/IP or OSI over 
TCP/IP) 

3. IBM MPTN architecture 
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This is shown in the following figure: 




Figure 236. Common Transport Semantics 

MPTN provides CTS for the following communication scenarios: 

1. TCP/IP Sockets over SNA 

2. SNA APPC and CPI-C over TCP/IP 

AnyNet/2 encompasses both CTS directions of MPTN. 

AnyNet/2 has the following hardware requirements, depending on which 



components of it you want to install: 
Table 21. AnyNet/2 System Requirements 


Component 


Disk Space (bytes) 


Sockets over SNA 


860 000 


APPC over TCP/IP 


360 000 


BookManager Documentation 


2 015 000 


PostScript Documentation 


2 700 000 



AnyNet/2 has the following software requirements, depending on which 
components of it you want to install, and in which environment you intend to use 
it: 

1. Operating System 

• OS/2 2.1 

• OS/2 2.0 

• OS.2 1.3 

2. Sockets over SNA 
APPC Interface 

• IBM Communications Manager/2 VI. 0 

• IBM Extended Services/2 VI. 0 

• OS/2 Extended Edition 1.3 plus Networking Services/2 
Sockets Applications 

• TCP/IP V2.0 for OS/2 Base Kit 

• TCP/IP V2.0 for OS/2 Network File System Kit 
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• TCP/IP V2.0 for OS/2 X Window System Server Kit 

• TCP/IP V2.0 for OS/2 Programming Kit 

• TCP/IP V2.0 for OS/2 Domain Name Server Kit 

• TCP/IP V2.0 for OS/2 Applications Kit 

• TCP/IP 1.2.1 for OS/2 with latest CSDs 

• User written 

3. APPC over TCP/IP 
APPC Interface 

• IBM Communications Manager/2 V1.0 
TCP/IP Interface 

• TCP/IP V2.0 for OS/2 

• TCP/IP 1.2.1 for OS/2 with latest CSDs 
APPC and CPI-C Applications 

• CICS OS/2 

• User written 

Documentation for the AnyNet/2 program is available in both BookManager and 
PostScript format, and it is contained on the product diskettes. Please refer to 
IBM AnyNet/2: Guide to APPC over TCP/IP and IBM AnyNet/2: Guide to Sockets 
over SNA for more information about CTS, MPTN, and their implementation in 
AnyNet/2. 

The following figure illustrates how AnyNet/2 fits into the IBM Networking 
Blueprint: 
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Figure 237. AnyNet/2 Within The IBM Networking Blueprint 

You can use AnyNet/2 for workstation to workstation or for workstation to host 
connections. In the latter case, you need VTAM Version 3 Release 4.2, and 
AnyNet/MVS. 

The main benefit of AnyNet/2 is that existing Sockets or APPC applications can 
use a different network transport but remain unchanged. 



19.1 Using Sockets over SNA 

This component of AnyNet/2 provides you with the capability to run Sockets 
applications across an SNA network, as shown in the following figure: 
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Figure 238. AnyNet/2 Installation - Install Complete Panel 

Note: Sockets over SNA provides you with a native TCP/IP protocol stack in 
addition to SNA transport, and it allows you to use both interfaces at the 
same time. This is not shown in the figure above. 

When an application starts a stream or datagram connection, Sockets over SNA 
first determines to which interface this request should be routed: 

1. Sockets over SNA 

2. TCP/IP protocol stack. 

TCP/IP interfaces are initialized using the IFCONFIG command, and the interface 
name for Sockets over SNA must be snaO. 

If the addressed interface is snaO, Sockets over SNA generates LU6.2 calls that 
correspond to that Socket call. These LU6.2 calls are then passed on to the 
APPC interface of Communications Manager. In this process, Sockets over SNA 
has to look up an IP to LU mapping table to determine the SNA fully qualified LU 
name that maps to the destination IP address specified in the application 
request, if it finds a mapping SNA address, it allocates a conversation and 
includes its own IP address in the connection request. 

There are two ways of setting up an IP-LU mapping table: 

1. Specifying LU names and IP addresses explicitly 

2. Using an LU template and letting Sockets over SNA determine the rest of the 
LU name algorithmically. 

The first option should be used if you plan to have only a few hosts 
communicating through Sockets over SNA. 

The second case allows you to map a large number of LUs to IP addresses 
without having to manually enter each matching pair. 

The mapping of IP to LU addresses is achieved as follows: 

1. IP addresses are divided into a network part and a host part, either 
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a. By the class of IP address they conform to, or 

b. By a subnet mask, or 

c. By both of the above. 

2. Fully qualified LU names consist of an SNA network name and an LU name 

3. The network part of the IP address will be mapped to the SNA network 
name. If you specify an LU template, that and the SNA network name will be 
mapped to the IP network. 

4. The host part of the IP address will be mapped to an LU name. If you specify 
an LU template, only the remaining characters up to a number of eight will 
be used for mapping; the characters of the LU template are fixed. 

Please refer to 16.6, “Establishing an IP Router with OS/2" on page 302 for an 
explanation of how to implement and use subnets. 

To use Sockets over SNA, you need to identify every host on that desired 
network with an IP address and a fully qualified SNA LU name. You should 
contact your network administrator(s) to obtain those addresses. 

If you choose to use an LU template, Sockets over SNA will create LU names 
algorithmically. If you connect to an SNA network through VTAM, those LUs 
must be defined to VTAM prior to use. AnyNet/2 provides a utility to convert an 
LU name or a range of LU names to IP addresses. The following example shows 
a conversion of a single IP address with a given subnet mask and an LU 
template: 

sxmap convert 9.67.32.1 255.255.255.192 WTR 

9.67.32.1 maps to LU name WTR00001 

Observe that the same IP address with a different subnet mask, but using the 
same LU template, will result in the same LU name! 

sxmap convert 9.67.32.1 255.255.255.0 WTR 

9.67.32.1 maps to LU name WTR00001 

On the other hand, the same IP address with a subnet mask that allows a wider 
range of host addresses, even though using the same LU template, will result in 
a different LU name! 

sxmap convert 9.67.32.1 255.255.0.0 WTR 

9.67.32.1 maps to LU name WTRG08O1 

For that reason, be careful with subnets and assign different LU templates for 
different networks and subnets. 

The following example shows how to convert a range of IP addresses into LU 
names, using an LU template of WTR: 

sxmap convert 9.67.32.1 9.67.32.15 255.255.255.240 WTR 

9.67.32.1 WTR00001 

9.67.32.2 WTR00002 

9.67.32.3 WTR00003 

9.67.32.4 WTR00004 

9.67.32.5 WTR00005 

9.67.32.6 WTR00006 

9.67.32.7 WTR00007 

9.67.32.8 WTR00008 

9.67.32.9 WTR00009 

9.67.32.10 WTR0000A 
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9.67.32.11 WTR0000B 

9.67.32.12 WTR0000C 

9.67.32.13 WTR0000D 

9.67.32.14 WTR0000F 

9.67.32.15 WTR00006 

The sxmap command can also be used to update the IP-LU table directly, to 
delete an entry from it, or to flush the entire table from memory. 

When you want to specify particular LU names to map to a certain IP address, 
you need to specify a subnet mask of 255.255.255.255. 

To apply the necessary parameters, the AnyNet/2 Configuration Notebook is 
used. It is called during installation, but can be accessed later by entering: 

anynetcf 



1 9.1 .1 .1 Configure Sockets over SNA 

The following figure shows the first page of the Sockets over SNA configuration: 




Figure 239. AnyNet/2 Configuration - Sockets over SNA, Page 1 



Setting 

IP Address for SNA 
Subnet Mask 

SNA Network Name 
LU Template 



Meaning 

IP address of your workstation 

Optionally specify the subnet mask that is in effect in your 
IP network 

Name of your SNA network 

Specify fixed characters for the LU names of that network. 



If you chose to use an LU template, the configuration is complete. 

If you chose to use direct IP-LU mapping, each host needs to define all other 
hosts on the network that it wants to communicate with using Sockets over SNA. 
This can be done on the next page. The following figure shows the second page 
of the Sockets over SNA configuration: 
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Figure 240. AnyNet/2 Configuration - Sockets over SNA, Page 2 

Setting Meaning 

IP Network ID IP address of a host on the Sockets over SNA network 

Subnet Mask Optionally specify the subnet mask that is in effect in your 

IP network 

SNA Network Name Name of your SNA network 

LU Template LU template or LU name assigned to that host. 

If you need to specify more addresses, select New Address. If you want to scroll 
backwards through already defined addresses, select Previous Address. 

This kind of mapping is also required if you need to communicate with hosts on 
a different IP network. 

When you have finished the configuration, select Close on the System menu icon 
of the Configuration notebook. 

19.1.1.2 Starting Sockets over SNA 

To start Sockets over SNA, AnyNet/2 provides the OS/2 command file 
\tcpip\bin\sxstart.cmd. Run this command file after Communications Manager is 
up, then start your Sockets application. 



19.2 Using TCP/IP over APPC 

This component of AnyNet/2 provides you with the capability to run applications 
written to the APPC or CPI-C interface across a TCP/IP network, as shown in the 
following figure: 
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Figure 241. AnyNet/2 Installation - Install Complete Panel 

Note: APPC over TCP/IP provides you with the capability to use either TCP/IP or 
SNA transport for your APPC applications at the same time. 

When an application starts an APPC conversation, APPC over TCP/IP first 
determines to which interface this request should be routed: 

1. APPC over TCP/IP 

2. SNA transport. 

APPC over TCP/IP uses a routing preference table (LUTAB.LST) to determine the 
preference of a routing request for each LU used by APPC applications. If the 
desired transport is TCP/IP, APPC over TCP/IP issues a gethosbyname() call to 
either a domain name server, or a local HOSTS file to resolve the LU name to an 
IP address. In this process, APPC over TCP/IP appends an SNA suffix to the fully 
qualified LU name. This resulting name will then be passed on to the name 
server to be resolved. The following example shows how a fully qualified LU 
name with a specified SNA suffix will be resolved into an IP address: 

SNA network name: USIBMRA 

LU name: WTR0O001 

SNA suffix: SNA.IBM.COM 

Domain name server record: 

$0RIGIN usibmra.sna.ibm.com. 

> 

@ IN SOA nameserver.usibmra.sna.ibm.com. 

nsadmin.usibmra.sna.ibm.com. ( 

93082401 ; Serial number for this data (yymmdd##) 
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93082401 ; Serial number for this data (yymmdd##) 
86400 ; Refresh value for secondary name servers 

300 ; Retry value for secondary name servers 

864000 ; Expire value for secondary name servers 

3600 ) ; Minimum TTL value 

» 

@ IN NS nameserver.usibmra.sna.ibm.com. 

wtr00001 IN A 9.67.32.1 

IN HINFO AnyNet/2 



resolved IP address: 

WTR00001.USIBMRA.SNA.IBM.COM is 9.67.32.1 

To apply the necessary parameters, the AnyNet/2 Configuration Notebook is 
used. It is called during installation, but can be accessed later by entering: 

anynetcf 

1 9.2.1 .1 Configure APPC over TCP/IP 

The following figure shows the first page of the APPC over TCP/IP configuration: 




Figure 242. AnyNet/2 Configuration - APPC over TCP/IP, Page 1 



Setting Meaning 

SNA Suffix Specify the SNA suffix that you want to use 
Critical WS Specify if this workstation is considered critical. 

The following figure shows the second page of the APPC over TCP/IP 
configuration: 
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Figure 243. AnyNet/2 Configuration - APPC over TCP/IP, Page 2 



Specify time-out and retry counts for APPC over TCP/IP on this page. 

When you have finished the configuration, select Close on the System menu icon 
of the Configuration Notebook. 

19.2.1.2 Starting APPC over TCP/IP 

To activate APPC over TCP/IP, do the following: 

1. Start TCP/IP 

2. Start IBM Communications Manager/2 VI. 0 

3. Start your APPC application. 



19.3 Installation 



To install the AnyNet/2 program, insert the AnyNet/2 diskette 1 into drive A: and, 
on an OS/2 command prompt, enter: 

A: INSTALL 

For the installation program to load may take some time during which you will 
see the following panel: 




Figure 244. AnyNet/2 Installation • System Check-out Panel 

After a short time the AnyNet/2 Installation screen will be displayed: 
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Before you install Sockets over SNA, be sure that SNACKETS.EXE and 
NNLIMCEXE are not running. You must stop these programs before you can || | 
install Sockets over SNA. 

Before you install APPC over TCP/IP, be sure that Communications 
Manager/2 aid FFST/2 are not running. You must stop these programs 
before you can install APPC over TCP/IP. 

Press Continue to install or Cancel to exit 







Figure 245. AnyNet/2 Installation - Initial Screen 

This screen first contains a short introduction to the AnyNet/2 program: Select 
Continue in the Introduction window. AnyNet/2 installation will now check 
whether you already have a version of it installed, and what components, if any: 




Figure 246. AnyNet/2 Installation - Version Check-out Panel 

Finally you get to the Installation and Maintenance menu which is shown in the 
following figure: 



Installation and Maintenance • 



View Details Action Help 






[DRIVE! Anyltet/2 Software 









01.00.00 APPC over TCP/IP 

01.00.00 BookManager Publications 

01.00.00 PostScript Publications 



Figure 247. AnyNet/2 Installation - Installation and Maintenance Window 
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This utility allows you to: 

1. Install a component 

2. Display a brief explanation about a component 

3. Show fixed disk requirements of a component 

4. Display status of current version of a component 

5. View contents of a component 

Select Sockets over SNA and then select Install from the Action menu. You will 
see the following menu: 




Figure 248. AnyNet/2 Installation - Install Menu for Sockets over SNA 

Check on Update CONFIG.SYS, then push the Okay button. The program then 
asks you for the directories where you want to install the selected component of 
AnyNet/2. 



Install - directories 



directories Where you want to lm^t.ite'pra£^ 



directories wiU t» created If they do n-'it aJ< rady ; 




Figure 249. AnyNet/2 Installation - Component Directory Window 



Fill in the directories (or leave the defaults), then press Install. The AnyNet/2 
installation progress indicator will show up: 
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Figure 250. AnyNet/2 Installation - Progress Indicator Window 

Occasionally, you will be asked to enter another one of the AnyNet/2 product 
diskettes: 



Insert disk 



/Please Insert the following < 

it 




Figure 251. AnyNetl2 Installation - Insert Next Diskette Panel 

Before the installation completes, it lets you enter configuration data for 
AnyNet/2 operation. This is performed using a Configuration Notebook similar to 
the one that you are already familiar with from TCP/IP V2.0 for OS/2. 

See 19.1.1.1, "Configure Sockets over SNA” on page 329 and 19.2.1.1, “Configure 
APPC over TCP/IP” on page 332 for a brief explanation on how to configure 
AnyNet/2 components. 

When you have finished the configuration, select Close on the System menu icon 
of the Configuration Notebook. The following panel will be displayed: 
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Figure 252. AnyNet/2 Installation - Install Complete Panel 



You are now returned to the Installation and Maintenance window to install 
another component of AnyNet/2. If you have finished installing the components 
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that you intended to use on your workstation, select Close on the System menu 
of the Installation and Maintenance window, and then press Exit in the AnyNet/2 
Installation window. 

Do not forget to reboot your workstation. 



19.4 OSF/DCE 



DCE provides interoperability and portability across heterogeneous 
environments, different operating systems and hardware platforms. DCE is a 
complete framework to help to enhance your environment. It supports new 
services to share data and resources as well as different kinds of equipment and 
devices, over distributed computing. It also helps you to upgrade and scale your 
environment independently from organization changes. 

Applications that are build using DCE are portable to other hardware and/or 
operating systems which run DCE. DCE provides flexibility and extensibility, if 
your company is growing. The DCE environment will grow with your company 
adding new cells, new principals or new services. 

If your organization is opening a branch office in another country, DCE will tie 
together and easily access resources across the different countries of different 
continents. Moreover DCE offers a secure and reliable environment where you 
can develop and run client/server applications in order to guarantee the right 
level of confidentiality, integrity and availability last but not least, DCE includes a 
set of management tools for administering all of the DCE services and many 
aspects of the distributed environment itself. 



19.5 OSF/DCE Architecture 

The OSF/DCE (Distributed Computing Environment) is a complete architecture, to 
help you to take advantage of the client/server model: 
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Applications 




DCE provides you with a complete set of services and facilities to build 
client/server applications, manage distributed services and interoperate with 
other environments. 



19.6 OSF/DCE Components and Services 

Here is the description of the DCE components and the technology it is based on. 



19.6.1 Threads 

Threads supports the creation, management, and synchronization of multiple 
paths of control within a single process. Threads specification was submitted by 
DEC** to the Open Software Foundation, and it is based on DEC'S Concert 
Multithread Architecture (CMA). Threads programming facility is also POSIX 
10003.4 draft compliant. If threads is already available on the operating system, 
DCE can use it. 

19.6.2 Remote Procedure Call 

This is a complete environment to help you develop client/server applications. A 
development tool consisting of a Interface Definition Language (IDL) is provided. 
The RPC run time service facilitate the implementation of the network protocols 
used from the client and server applications to communicate. One of the RPC's 
components is the uuidgen program, that generates UUIDs (a 32 digit number) to 
uniquely identify resources, servers and users in DCE, independently from time 
and space. The RPC specification was submitted by Apollo/HP** and is based on 
Network Computing Systems (NCS) release 2. 
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19.6.3 Security 



Distributed computing encourages a free flow of data between nodes, expanding 
the capabilities of interconnetivity and interoperability. Security breaches might 
come from network software monitor or devices. 

Data might be read as it flows over the network, a computer can pretend to be 
another system and thus gain access to restricted resources or data can be 
altered in transit by an non authorized party. This is too risky for businesses 
that rely on integrity and confidentiality of their data. 

For that reason security is a critical component in a distributed computing 
environment. A big concern is authentication of client and server in the system. 

DCE security consists of: 

• DCE Authentication Service 

• DCE User Registry Privilege Service 

• DCE Login Facility 

• Access Control List (ACL) 

• Secure RPC 

Core services in DCE such as Cell Directory and Distributed Time Service use 
the Security Service. 

Administration tools are provided to manage the DCE Security Service. 

The specification for DCE Security Service was submitted by MIT**. It is based on 
Kerberos V5.1, plus some services from HP. 

19.6.4 OSF/DCE Directory Service 

Directory Service is a central repository for all objects and their attributes within 
a DCE environment. An object may be a network resource, service, user, and a 
node available through DCE. 

The DCE Directory Service includes: 

• Cell Directory Service (CDS) 

• Global Directory Service (GDS) 

• Global Directory Agent (GDA) 

• Programming Application Interface (API) 

The CDS manages information within a cell. The GDS provides a global 
namespace to participate in a worldwide connection and is based on the CCITT** 
X.500 name scheme. The GDA is the CDS gateway to GDS. Both CDS and GDS 
use X/OPEN** Directory Service (XDS) API as a programming interface. 

The specification of DCE Directory Service was submitted by DEC and 
Siemmens/Nixdorf** (SNI). It is based on DEC Name Service DNS for DCE 
Directory Service and Siemmens/Nixdorf DIR-X implementation of X.500 for the 
GDS. 
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19.6.5 OSF/DCE Distributed Time Service 

Distributed Time Service (DTS) provides precise, fault tolerant clock 
synchronization time on the computers participating in a DCE environment both 
over LAN and WAN. 

The synchronized clock enable DCE application to determine event sequencing, 
duration and scheduling. DTS is based on Coordinated Universal Time (CUT), an 
international standard. The specification of Distributed Time Service was 
submitted by DEC and it is based on DEC Distributed Time Synchronization. 

19.6.6 OSF/DCE Distributed File System 

With Distributed File System (DFS) directories and files can be accessed from 
users anywhere on the network, using the same name since all DCE resources 
are part of a global namespace. High performance is achieved through caching 
on the client side in order to reduce access time and network traffic. 

DCE includes a Local File System (LFS). LFS is a fast restarting log-based 
physical file system that allows files replication for high high availability. 

Files and directories can be protected using the Access Control List (ACL). You 
can define an ACL for each file and specify the exact granularity for user, group 
and organization to restrict/permit access to files on DFS. 

DFS interoperates with NFS and is built on the top of the core technologies 
Security Services, Cell Directory Service, and Distributed Time Service. DFS also 
make use of threads and RPCs. DFS is a superset of POSIX 1003.1 file system 
semantic standard. DFS was submitted by Transarc Corporation**, DFS is based 
on the Andrew File System** 



19.7 OSF/DCE for OS/2 

The IBM Distributed System Services is a set of products for the area of 
micro-computers with the main objective of giving interoperability to 
heterogeneous equipments. It includes the availability of distributed services that 
offers different resources to that distributed environment. The IBM DCE for OS/2 
is the first product that complies with the IBM Distributed Systems Services. 

19.7.1 Function Summary 

IBM DCE for OS/2 supports: 

• CDS Server (primary and secondary) and Clerk 

• Security Service Server and Client 

• Remote Procedure Call Client and Server 

• Threads Service 

• DTS Service Server and Clerk 
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19.7.2 Packaging 

IBM DCE for OS/2 VI. 0 is packed in six 3.5 diskettes which includes all the 
functions listed above. 

Warning!. 

Before installing DCE for OS/2, it is necessary that TCP/IP and Multi-Protocol 
Transport Services (MPTS), that comes with AnyNet/2, are installed. 



19.7.3 Operating Environment 

IBM DCE for OS/2 runs on all OS/2 capable hardware with at least 16MB of 
memory and at least 160MB hard disk, but as the cell grows it is possible that 
you have to increase the hard disk space. 

• DCE client requires 5.4MB of disk space. 

• Security Server and CDS server requires more 0.8MB of disk space. 

• The tools requires 3.1MB of disk space. 

On nodes where you are also going to develop DCE applications you will also 
need: 

• C-Set/2 

• IBM Developer's Toolkit for OS/2 



19.8 Implementation 

For information on installation and configuration of IBM DCE for OS/2, please 
refer to OSF/DCE for OS/2 Overview, which has the document number: 
GG2441 44-00. 
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Chapter 20. TCP/IP V2.0 for OS/2 and NetWare Coexistence 



TCP/IP coexistence is defined as running concurrently with other protocol stacks 
and sharing a single LAN adapter. This chapter explains what is needed to share 
the same LAN adapter between IBM's TCP/IP V2.0 for OS/2 and Novell's 
NetWare**. 



20.1 Coexistence Overview 

TCP/IP V2.0 for OS/2 can coexist with NetWare for OS/2 2.1 using the ODI2NDI, 
ODINSUP or LANSUP drivers. 

The current version of NetWare Workstation for OS/2 is 2.01. It is available with 
NetWare 4.0 and NetWare 4.01, as a separate client kit. 

The NetWare Workstation for OS/2 V2.01 supports both IBM OS/2 2.0 and 2.1. 

Full screen and windowed OS/2 sessions are fully supported by the NetWare 
3.11, 4.0, and 4.01 environments. 

The NetWare Workstation for OS/2 V2.01 product does not provide native NDIS 
support. However, Novell provides two methods to make coexistence possible: 

• ODINSUP 

• LANSUP 

The first method uses the Novell ODINSUP.SYS driver to provide NDIS to ODI 
conversion. When ODINSUP.SYS is used, the LAN adapter uses an ODI LAN 
driver and NDIS based stacks go through an NDIS to ODI conversion handled by 
ODINSUP.SYS. ODINSUP uses ODI drivers to control the LAN adapter. 

The second method uses the Novell LANSUP.SYS driver, which replaces the 
Novell CMGRLAN.SYS driver used by the NetWare Requester for OS/2 EE VI .3. 
The LANSUP.SYS driver uses the IEEE 802.2 API, consequently, use of the 
LANSUP driver also requires concurrent installation of a product that provides 
the IEEE 802.2 API. The IEEE 802.2 API support is provided by NTS/2, Extended 
Services for OS/2 VI .0, OS/2 LAN Server V2.0, and LAN Enabler V2.0. The 
LANSUP driver provides support for only one of the four commonly used 
NetWare Ethernet frame types: ETHERNET_802.2. The ETHERNET_SNAP, 
ETHERNET_802.3 and ETHERNETJI frames are not supported. Because the 
ETHERNET_802.2 is the only frame type supported by LANSUP, you cannot use 
the LANSUP method if you need to login to a NetWare 2.x file server. NetWare 
2.x file servers can only support the ETHERNET_802.3 and ETHERNETJI frame 
types. 

An alternative to ODINSUP.SYS and LANSUP.SYS for TCP/IP and NetWare 
coexistence is the ODI2NDI.OS2 driver in the IBM NTS/2 product. If you need to 
login to a NetWare 2.x server, and need to share the LAN adapter with other 
protocol stacks, use the ODI2NDI or the ODINSUP methods. 
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— Read This! 

Software incompatibility problems between the the NetWare ODINSUP driver 
and IBM LAN Network Manager do NOT allow these two products to share 
the same LAN adapter today. Use the NTS/2 ODI2NDI driver for TCP/IP, 
NetWare and LAN Network Manager coexistence. 



20.2 The Alternatives For TCP/IP and NetWare Coexistence 
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Figure 254. TCP/IP and NetWare Coexistence Alternatives 

There are three alternative configurations available for TCP/IP and NetWare 
coexistence on OS/2 Version 2.0 systems. The ODI2NDI.OS2 and LANSUP.SYS 
drivers uses an NDIS based protocol stack while the ODINSUP.SYS driver uses 
an ODI based protocol stack. The LANSUP.SYS and ODINSUP.SYS coexistence 
drivers are shipped with the NetWare Workstation for OS/2 product. The IBM 
Network Transport Services/2 product includes the ODI2NDI.OS2 coexistence 
driver which emulates an ODI MUD adapter driver to the NetWare IPX/SPX 
protocol stack. 

When an OS/2 NDIS MAC driver is available for the LAN adapter, the NTS/2 
ODI2NDI driver provides the most flexible configuration for NetWare coexistence. 
ODI2NDI provides better NetWare performance than the LANSUP driver and 
comparable performance to ODINSUP. ODI2NDI does not require or use the 
direct IEEE 802.2 API, like the LANSUP driver, so it can coexist with other 
products that use this API. For example, the IBM LAN Network Manager product 
uses the direct IEEE 802.2 API. In a NetWare Ethernet environment, use of the 
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0DI2NDI driver is not limited to ETHERNET_802.2 frame support. LANSUP only 
supports the NetWare ETHERNET_802.2 frame type and this is a problem in 
networks with NetWare 2.x servers, since NetWare 2.x servers can only support 
the ETHERNET_802.3 and ETHERNETJI frame types. 

Use of the ODI2NDI driver requires minimal definitions in the NetWare NET.CFG 
file. In fact, the two OOI2NDI examples in this book required only the PACKET 
BURST OFF command, in the NET.CFG file, to work successfully. Use of the 
ODI2NDI driver requires purchase of the IBM NTS/2 product, which includes a 
LAPS utility that is similar to the LAPS support in IBM TCP/IP V2.0 for OS/2. The 
NTS/2 LAPS utility will install and configure the ODI2NDI driver, and does not 
require the user to make manual changes to the CONFIG.SYS or PROTOCOL.INI 
files. 

The Novell LANSUP.SYS driver, replaces the Novell CMGRLAN.SYS driver used 
by the NetWare Requester for OS/2 EE V1.3. Both the earlier CMGRLAN.SYS 
driver and the LANSUP.SYS driver use the direct IEEE 802.2 API. Use of the 
LANSUP driver requires additional software to provide the IEEE 802.2 API. The 
IEEE 802.2 API is provided by NTS/2, Extended Services for OS/2, OS/2 LAN 
Ser/er V2.0 and LAN Enabler V2.0. CM/2 and OS/2 LAN Ser/er V3.0 use NTS/2. 
Installation and configuration using the LANSUP driver requires few manual 
changes to CONFIG.SYS, and does not require the user to make changes to the 
PROTOCOL.INI file. 

The Novell ODINSUP driver, and the ODI stack, is included with the NetWare 
Workstation for OS/2 V2.01. ODINSUP allows NDIS based protocol stacks to 
share a LAN adapter using the ODI stack. The ODINSUP driver provides a NDIS 
interface to native NDIS applications. ODINSUP then interfaces with the ODI LSL 
for eventual transmission by the ODI MLID LAN driver. When using ODINSUP, an 
OS/2 ODI MLID driver for the LAN adapter is required. 

ODINSUP should be used when an OS/2 NDIS MAC Driver for the LAN adapter is 
not available. When using ODINSUP, native ODI applications like NetWare work 
unchanged, so the use of ODINSUP and the native ODI stack can* also be used if 
your primary use of the LAN adapter will be for access to NetWare servers. 
ODINSUP provides better NetWare performance than LANSUP, but degrades 
performance of native NDIS stacks like IBM TCP/IP for OS/2. Configuration of 
ODINSUP with NDIS based applications, like IBM TCP/IP V2.0 for OS/2, requires 
manual changes to the CONFIG.SYS and PROTOCOL.INI files. 

20.2.1 TCP/IP, NetWare (ODI2NDI, Token-Ring) 

This example was completed on a PS/2 Model 80 system with an IBM 
Token-Ring Network Adapter/A, running OS/2 V2.1, TCP/IP V2.0 for OS/2, NTS/2 
(WR07020) and NetWare Workstation for OS/2 V2.01 (with Novell November 5, 
1993, R201FX fixes applied). 

When using ODI2NDI: 

1. If you have NTS/2 LAPS Version 2.14 or higher, install TCP/IP with LAPS. 
NetWare then NTS/2. 

2. If you have the original NTS/2 LAPS Version 2.11, install NTS/2, TCP/IP with 
LAPS then NetWare. Run NTS/2 LAPS CONFIGURATION again to correct 
CONFIG.SYS ordering and comment out ODI MLID driver. 
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3. If NetWare was installed after NTS/2, run NTS/2 LAPS CONFIGURATION 
again to correct CONFIG.SYS ordering and comment out the ODI MUD 
driver. 

4. Edit LAPS NETWARE REQUESTER SUPPORT to select correct frame type. 
Change TOKEN-RING = YES and/or TOKEN-RING_SNAP = YES. 

5. When using the IEEE universal address, edit LAPS NETWARE REQUESTER 
SUPPORT and set NETADDRESS = the universal LAN adapter address. You 
can use the TCP/IP NETSTAT -n command to obtain the universal address. 

6. When using a local adapter address, edit LAPS NETWARE REQUESTER 
SUPPORT and set NETADDRESS = the local LAN adapter address. You must 
also edit LAPS IBM TOKEN-RING NETWORK ADAPTERS, to include the local 
address in the IBMTOK_nif section of PROTOCOL.INI. 

7. You may have to comment out the IBMCOM LANPDD.OS2 and LANVDD.OS2 
drivers in CONFIG.SYS after NTS/2 LAPS configuration or error LT00303 
occurs if 802.2 or NetBIOS API drivers are not loaded. Review 
LANTRAN.LOG file, in the IBMCOM subdirectory, for errors. 

The CONFIG.SYS file modifications: 
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LIBPATH-C:\I8MC0K\Qll;.;C:\O$Z\DLl;C:\OS?\MOOS;C:\;C:\OS?\APPS\DLL;K:\M4OS2\OLl; 
H:\OSTCP280\Dll;K:\NWARE281 i 

SET PATH-C :\DS2 ;C :\0S2\SYSTEM;K :\OS2\MOOS\WI N0S2 ;C : \0S2\ I NSTAl l ;C :\ ;C :\0S2\M00S ; 
C:\0S2\APPS;K:\W0S2:h:\uti1 s;H:\OSTCP2Q0\BlM;K:\KWARE2ei ; L:\0S2{P:\0S2i 
SET DPATH«C:\IBMCOM;C:\OS2;C:\OS2\SYSTEMjK:\QS2\MOOS\WlNO$2;C:\QSZ\INSTALUC:\; 
C:\0S2\BI TKAP ;C :\0S2\M00S ; C :\0S2\APPS ; K:\W0S2 ; K :\W0$2\ I NSTAL L ;K:\NWARE201 ; 
L:\OS2;P:\OS2; 

SET HE IP- C : \0S2\HE IP ;C : \0S2\HE LP\TUTORI AL ;K: WQS2\HE LP ; H:\0STCP288\MELP ; 

PRI QRI TY_OI SK_I O-YES 
FUES-20 

QEVICE-C:\IBKC0MUANM$GD0.0S2 /I:C:\IBMCOM 
DEVICE*C:\IBMC0MVPR0THAN.0$2 /I:C:\IB«COH 
0EVICE»C:\0S2\TESTCFG.SYS 
DEVICE -C:\0S2\00S. SYS 

SET BOOKSKElF-C:\OS2\BCOK:K:VMOS2;H:\OSTCP268\DOC; 

DEVI CE-K:VftOS2\AOSKDD. SYS 

DEVICE -K:\W0S2\SHVDD. SYS 

RUN-C :\I BKCOK\PROTOCOL\NETBI NO . EXE 

RUN- C:\IBKC0«U ANMSCEX.EXE 

DEVICE -C:\I0MCOM\PROTOCOL\I NET .SYS 

DEVICE -C:\IBHCCW\PROTOCOt\IFNDIS. SYS 

DEVICE -C:\IBHCOM\MACS\IBMTOK.QSZ 

SET ETC*H:\0$TCP260\ETC 

SET TMP-H j\OST CP260\TMP 

SET READIBM-H:\OSTCP280\OOC 

SET KQSTKAHE-Dordor 

RUN-H :\OST CP268\BI N\CNTRL .EXE 

IFS-H:\OSTCP289\BIN\NFS208.IFS 

DEVI CE-M :\OSTCP269\BI N\VOOSTCP . VDD 

DEVI CE-H :\OSTCP209\BI N\VOOSTCP .SYS 

RUN- H:\OSTCP200\BI N\VDOSCTL.EXE 

SET L18-H:\0$TCP269\II6 

SET INCLUDE-H:VOSTCP290\INCLUDE 

SET OISPLAY-i>ordor:0 

SET XFILES-H:\OSTCP289\Xll 

SET XFILESEARCHPATH-H:\0STCP268\X1 I 

SET XAPP LRESD I R-H :\0STCP269\X1 1 

SET XEKVI RONMENT -H:\OSTCP289\ETC\Xresource 

SET XKEYSYMDB-H :\OSTCP208\XKey sycOB 

SET TZ-estSedt 

SET NFS. PERMISSION. BITS-700 

SET NFS. PERMISSION. OBITS- 789 

SET LPR_SERVER-cordor 

SET LPR_PRINTER-Iptl 

SET USER-CCnsorti 

SET PASSWD-orioles 

SET TElNET.PASSWORO.IO-orieles 

SET NEWSSERVER-yRtntws.w8tSOn.iba.coa 

SET SYSCONTACT-Joe Consorti *6828 

SET SYSLOCATION-IBM Washington Systtos Ctnttr 

REM — NetWare Requester statements BEGIN — 

SET NWL AKGUAGE -ENGLISH 

DEVICE-K:\NWARE291\LSL.SYS 

RUN-K:\NWARE201\DDAEMON.£XE 

device - C:\ibacoo\protQCol\odtZndi.os2 

REM DEVICE -K:\NMAAE201\TOXEN.SYS 

DEVICE-K:\NWARE201\ROUTE.SYS 

OEVICE-K;\NWAR£201\IPX.SYS 

DEVICE-Kt\NWARE201\SPX.SYS 

RUN-K:\NWAR£291\SPOAEMON.£XE 

r*a DEVICE -K:\NWARE201\NMP1PE. SYS 

reo DEVICE -K:\NWARE201\NPSERVER. SYS 

ran RUN-K:\NWARE281\NP0AEM0N.EXE 

DEVICE-K:\NWARE201\NWREO.SYS 

IFS-X:\KWARE291\NWIFS.IFS 

RUN-X:\NWARE29)\NWDAEM0N.EXE 

ren DEVICE -K:\NWARE281\NETBI OS. SYS 

rea RUN-K : \NWARE28l\NB0AEMON .EXE 

DEVI CE-K:\NWARE201\VIPX. SYS 

DEVI CE -K:\NWARE201\VSHE L L . SYS PRI VATE 

REM •— NetWare Requester statements END *— 



Notes: 

1. Install earlier LAPS (NTS/2 or TCP/IP) before older LAPS (NTS/2 or TCP/IP). 

2. Configure NTS/2 LAPS and add NetWare Requester from PROTOCOLS menu. 

3. Edit "LAPS NetWare Requester Support" to select correct token-ring frame 
type and add universal or local LAN adapter address. 

4. You may have to comment out the IBMCOM LANPDD.0S2 and LANVDD.0S2 
drivers. 
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The PROTOCOL.INI file: 



This is the PROTOCOL.INI file created by NTS/2 and TCP/IP LAPS installation 
and configuration. A local LAN adapter address was specified. No manual 
changes were required. 



/ — \ 

[PROTJIAN] 

DRIVERNAME = PROTMANJ 

[IBMLXCFG] 

0DI2NDI_nif = 0DI2NDI.nif 
TCPIPjiif = TCPIP.NIF 
IBMTOK_nif = IBMTOK.nif 

[0DI2NDI_nif] 

DriverName = odi 2ndi $ 

Bindings = IBMTOK_nif 
NETADDRESS = “400012461234" 

TOKEN-RING = "yes* 1 
TOKEN-RING_SNAP = ,, yes ,, 

ETHERNET J02. 3 = "no 0 
ETHERNET_802.2 = "no" 

ETHERNET I I = "no" 

ETHERNET SNAP = "no" 

TRACE = 0x0 

[TCPIP_nif] 

DriverName = TCPIP$ 

Bindings = IBMTOK^nif 

[IBMTOK_nif] 

DriverName = IBMT0K$ 

ADAPTER = “PRIMARY" 

NETADDRESS = “400012461234“ 

MAXTRANSMITS = 6 
RECVBUFS = 2 
RECVBUFSIZE = 256 
XMITBUFS = 1 

V J 



The NET.CFG file: 

This is the NET.CFG file that was used for this configuration. 



r 




\ 


netware requester 






preferred server drumpoint 


; Drumpoint is Preferred NetWare Server 




directory services off 


; No NetWare 4.0 Servers in the Network 




packet burst off 


; This was REQUIRED in our Tests 


J 



20.2.2 TCP/IP, NetWare (ODI2NDI, Ethernet) 

This example was completed on a PS/2 model 80 system with a 3Com 3C523 
EtherLink/MC adapter, running OS/2 V2.1, TCP/IP V2.0 for OS/2, NTS/2 (WR07020) 
and NetWare Workstation for OS/2 V2.01 (with Novell November 5, 1993, R201FX 
fixes applied). 

When using ODI2NDI: 

1. If you have NTS/2 LAPS version 2.14 or higher, install TCP/IP with LAPS, 
NetWare then NTS/2. 
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2. If you have the original NTS/2 LAPS Version 2.11, install NTS/2, TCP/IP with 
LAPS then NetWare. Run NTS/2 LAPS CONFIGURATION again to correct 
CONFIG.SYS ordering and comment out ODI MUD driver. 

3. If NetWare was installed after NTS/2, run NTS/2 LAPS CONFIGURATION 
again to correct CONFIG.SYS ordering and comment out ODI MUD driver. 

4. Edit LAPS NETWARE REQUESTER SUPPORT to select correct frame type. 
NetWare Ethernet V2.x and V3.x servers uses the default ETHERNET_802.3 
frame support. 

5. When using the IEEE universal address, edit LAPS NETWARE REQUESTER 
SUPPORT and set NETADDRESS = the universal LAN adapter address. You 
can use the TCP/IP NETSTAT -n command to obtain the universal address. 

6. When using a local adapter address, edit LAPS NETWARE REQUESTER 
SUPPORT and set NETADDRESS = the local LAN adapter address. You must 
also edit LAPS 3COM 3C523 ETHERLINK/MC ADAPTER, to include the local 
address in the ELNKMC_nif section of PROTOCOL.INI. 

7. You may have to comment out the IBMCOM LANPDD.OS2 and LANVDD.OS2 
drivers in CONFIG.SYS after NTS/2 LAPS configuration or error LT00303 
occurs if 802.2 or NetBIOS API drivers are not loaded. Review 
LANTRAN.LOG file, in the IBMCOM subdirectory, for errors. 

The CONFIG.SYS file modifications: 
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\ 

LIBPATH-C:\I BMCOK\DLL ; . ;C :\OS2\Ol l ;C :\OS2\MOOS; C:\;C :\0S2\APPS\0l L; K:\ff1OS2\0l L ; 

H:\05TCP2Q8\0L l ;K:\NWARE281 ; 

SET PATK-C:\QS2iC:\OS2\SY$TEMiK:\OS2\MOOS\WINOS2;C:\OS2\IN$TAlL;C:\;C:\OS2\MOOS; 

C:\0S2\APPS jK:\WOS2;h:\uU 1 s;H:\OSTCP208\BIN;K:\NWARE281 ;l:\0S2;P:\0S2; 

SET DPATH-C :\IGMC0M; C:\0S2iC :\0S2\SYSTEM;K:\Q$2\K00$\WIN0S2 ;C ;\OS2\I NSTAL L;C:\; 

C:\QS2\BITMAP ; C: \OS2\MOOS; C :\0S2\APPS ;K:\mOS2 iK: \W0S2\I NSTAL l ;K:\NWARE28l ; 

L:\0S2 ;P:\0S2; 

SET KEIP-CJ \0S2\HE LP;C :\OS2\HE LP\TUT ORIAL ;K:\W0S2\HE LP S H:\0STCP288\KE IP ; 

PRIORITY_DISK_IO«YES 

FILES-26 

DEVIC£«C:\IBMC0M\LANMSGDD.0S2 /I:C:\IBMCOH 
OEVICE«C:\IBMCOM\PROTMAN.OS2 /I:C:\IBMCOM 
OE VI CE »C J\0S2\TESTCFC .SYS 
0EVICE-C:\0S2\D0S.SYS 

SET B0OKSHElF-C:\O52\BOGK;K:\mOS2;H:\OSTCP268\DOC; 

DEVICE -K:\PMQSZ\ADSHDD . SYS 

DEVICE -K:\WOS2\SMVOD. SYS 

RUN»C:\1 BMC OM\PROTOCOL\NETB1ND.EXE 

RUN«C:\I BMCOH\LANKSGEX.EXE 

DEVI CE-C:\I BKCOKVPROTOCO L\I NET . SYS 

DEVI CE-C :\I BMCOM\PROTOCOL\ I FKOI S . SYS 

OE VI CE-C :\I BMCOM\MACS\£ LNKKC .OS2 

SET ETC-H:\0STCP2CB\ETC 

SET TMP-H:\0STCP268\TMP 

SET REAOIBH-H:\OSTCP26B\OOC 

SET HOSTNAME-ncrdor 

RUN-H :\0STCP288\BI N\CNTRL.EXE 

IFS*H:\0STCP298\BIN\KFS2S8.IFS 

DEVI CE*H:\OSTCP260\BI N\VDOST CP. VDD 

0EVICE-H:\0STCP268\BIN\VB0STCP.SYS 

RUN»H:\QSTCP208\BIN\ VOOSCU.EXE 

SET LIB-H:\OSTCP280\LIB 

SET INCLUDE*H:\OSTCP208\INCLUDE 

SET DISPlAY-uordoriB 

SET XFlLES-H:\OSTCP280\Xn 

SET XFI LESEARCHPATH-H :\OSTCP280\X1 1 

SET XAPPLRESDIR-H:\0STCP288\X11 

SET XENVI RONMENT -H:\0STCP288\ETC\Xrescurce 

SET XKEYSYMDB*H:\OSTCP208\XKeysycDB 

SET TZ-est5edt 

SET NFS.PERMISSION.BITS-788 

SET NFS.PERHISSION.DBITS-760 

SET IPRJERVER-cordor 

SET LPR_PRINTER-1ptl 

SET USER-COnsorti 

SET PASSWO-orloles 

SET TELNET. PASSWORQ.IO-onoles 

SET NEWSSERVER-yktnews . wet son. i bn . con 

SET SYSCONTACT-Joe Consort i xBB20 

SET SYSLOCATION-IBM Washington Systems Center 

REM — NetWare Requester statenents BEGIN — - 

SET NWLAN6UACE-ENGLISH 

DEVI CE »K :\NWARE201 \LSL . SYS 

RUN-K:\NWARE281\D0AEM0N.EXE 

device - C:\ibccan\protocol\odi2ndi.os2 

REM DEVICE -K:\NWARE20I\3C523. SYS 

DEVI CE-K:\NWARE28l\IPX. SYS 

OEVI CE-KS\NWARE281\SPX . SYS 

RUN-K :\NWARE28I\SPDAEK0N . EXE 

rent OEVICE«K:\NWARE201\NMPIPE.SYS 

rem OEVICE-K:\NWARE28l\NP$£RVER.SY$ 

rem RUN-IC\NVARE20I\NPBAEMON.EXE 

DEVICE -K:\NWARE281 \NWREQ . SYS 

IFS-K:\NWARE201\NWIFS.1FS 

RUN- K:\NWARE20 l\NWOAEMGN.EXE 

rera DEVICE-K:\NWARE281\NETBI0S.SYS 

ren RUK-K:\KWAAE281\NB0AEKGN.EXE 

DEVI CE*K:\NWAR£281\VIPX. SYS 

OEVICE»K:\NWARE201\VSHELL.SYS PRIVATE 

REM -•« NetWare Requester statements END --- 

/ 



Notes: 

1. Install earlier LAPS (NTS/2 or TCP/IP) before later LAPS (NTS/2 or TCP/IP). 

2. Configure NTS/2 LAPS and add NetWare requester from PROTOCOLS menu. 

3. Edit "LAPS NetWare Requester Support" to select correct Ethernet frame 
type and add universal or local LAN adapter address. 

4. May have to comment out the IBMCOM LANPDD.OS2 and LANVDD.OS2 
drivers. 

The PROTOCOL.INI file: 
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This is the PROTOCOL.INI file created by NTS/2 and TCP/IP LAPS installation 
and configuration. A local LAN adapter address was specified. No manual 
changes were required. 



/ 

[PROT MAN] 

DRIVERNAME = PR0TMAN$ 


N 


[IBMLXCFG] 

0DI2NDI nif = 0DI2NDI.NIF 
TCPIP nif = TCPIP.NIF 
ELNKMC_nif = ELNKMC.nif 




[00I2NDI_nif] 

DriverName = odi2ndi$ 
Bindings = ELNKMC nif 
NETADDRESS = "488012345678" 
TOKEN-RING = "no" 

TOKEN-RING SNAP = "no" 
ETHERNET 882.3 = “yes" 
ETHERNET 882.2 = "no" 
ETHERNET II = "no" 

ETHERNET SNAP = "no" 

TRACE = 8x8 




[TCPIPjiif] 

DriverName = TCPIP$ 
Bindings = ELNKMC jiif 




[ELNKMC_ni f] 

DriverName = ELNKMC$ 
netaddress = "488812345678“ 
maxtransmits = 12 

V- 





The NET.CFG File: 

This is the NET.CFG file that was used for this configuration. 



r 

netware requester 

preferred server drumpoint 
directory services off 


; Drumpoint is Preferred NetWare Server 
; No NetWare 4.0 Servers in the Network 


A 


packet burst off 


; This was REQUIRED in our Tests 


) 



20.3 NetWare And LANSUP.SYS 

The Novell LANSUP.SYS driver, provided with NetWare Workstation for OS/2 
V2.01 replaces the Novell CMGRLAN.SYS driver used by the NetWare Requester 
for OS/2 EE V1.3. Both the earlier CMGRLAN.SYS driver and the LANSUP.SYS 
driver use the direct IEEE 802.2 API. Because LANSUP uses the direct 802.2 API, 
it cannot share a LAN adapter with other protocol stacks or applications that 
also use the direct 802.2 API. IBM LAN Network Manager also uses the direct 
802.2 API. The LANSUP driver only supports the ETHERNETJ02.2 NetWare 
Ethernet frame type. The three other NetWare Ethernet frame types, 
ETHERNETJ3NAP, ETHERNET_802.3 and ETHERNETJI, are not supported. 
Because the ETHERNET_802.2 is the only frame type supported by LANSUP, you 
cannot use the LANSUP driver if you need to login to a NetWare 2.x file server. 
NetWare 2.x file servers can only support the ETHERNET_802.3 and ETHERNETJI 
frame types. If you need to login to a NetWare 2.x server, and need to share the 
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LAN adapter with other protocol stacks, use the ODINSUP or ODI2NDI drivers. 

When configuring LANSUP remember the following: 

1. Use of LANSUP for TCP/IP and NetWare Coexistence Requires the IEEE 802.2 
API. 

2. LANSUP does NOT require manual changes to the PROTOCOL.INI file. Use 
LAPS to add the IEEE 802.2 protocol stack to PROTOCOL.INI. A NET.CFG file 
is required for LANSUP. 

3. Manually add the NetWare ROUTE.SYS statement to CONFIG.SYS for 
networks using token-ring source route bridges. If this ROUTE.SYS 
statement is missing, you will get a NetWare 'REQ0815: The Program Cannot 
Get The Connection ID. Error 0x880F' message during OS/2 boot. 

4. When using LANSUP with Ethernet adapters, you MUST specify the NetWare 
Ethernet_802.2 frame type in both the NetWare requester NET.CFG file and 
the NetWare server AUTOEXEC.NCF file. Note that the default frame type for 
Ethernet ODI drivers, for example NE2000.SYS, was changed in NetWare v4.0, 
they now default to Ethernet_802.2. In NetWare v3.x and NetWare v2.x, 
Ethernet drivers defaulted to Ethernet_802.3. NetWare v4.0 server drivers for 
Ethernet default to Ethernet_802.2 frame type. For example, our NetWare 
3.11 server AUTOEXEC.NCF file included: 

load 3c523 slot=7 frame=Ethernet_802.3 name=ipx8023 net=l 
bind ipx to ipx8023 net=l 

load 3c523 slot=7 frame=Ethernet_802.2 name=ipx8022 net=10 
bind ipx to ipx8022 net=10 

5. Specify the NODE ADDRESS parameter on the LINK DRIVER statement in the 
NET.CFG file. Do NOT exclude NODE ADDRESS from NET.CFG or a NetWare 
'NWD0115: Error Getting Connection Id. 0x880F' error message will result and 
NetWare will NOT connect to the server. If you do NOT know the LAN 
adapter universal or local address, specify 'NODE ADDRESS 400001234567' in 
NET.CFG. After rebooting, the NetWare message 'NET.CFG, node address is 
different from adapters, Should be 10005a220cd7m' Will Display. Use these 
13 hex digits for the NODE ADDRESS value in NET.CFG and reboot. The 13th 
digit, is either a L or M, and indicates whether the NODE ADDRESS value is 
in Least Significant Bit (LSB) first format or Most Significant Bit (MSB) first 
format. 

6. LANSUP supports both LSB first and MSB first formats for node addresses. 
When using LANSUP, NetWare node addresses for Ethernet frames default to 
LSB mode and token-ring frames default to MSB mode. For token-ring 
adapters, the NET.CFG NODE ADDRESS value will look different than the 
PROTOCOL.INI NETADDRESS value if NODE ADDRESS in NET.CFG is 
specified in LSB first format. For Ethernet adapters, the NET.CFG NODE 
ADDRESS will look different than the PROTOCOL.INI NETADDRESS value if 
NODE ADDRESS in NET.CFG is specified in MSB first format. For example, if 
the PROTOCOL.INI NETADDRESS for a Ethernet adapter is 400012345678, the 
NET.CFG NODE ADDRESS value in LSB format is 400012345676 and the 
NET.CFG NODE ADDRESS value in MSB format is 0200482C6A1E. LSB format 
40 hex, or 0100 0000 binary, corresponds to 0000 0010 binary, or 02 hex, in 
MSB format. 

Note: LSB first format should be used with IBM 8209 bridges when 8209 
bridges are used to transfer frames from Ethernet segments to 
token-ring segments and IPX support has NOT been enabled on the 
8209. Use NET ADDRESS MSB first format if IPX support has been 
enabled on the 8209. 
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20.3.1 TCP/IP, NetWare (LANSUP, Token-Ring) 

This example was completed on a PS/2 Model 80 system with an IBM 
Token-Ring Network Adapter/A, running OS/2 V2.1, TCP/IP V2.0 for OS/2, NTS/2 
(WR07020) and NetWare Workstation for OS/2 V2.01 (with Novell November 5, 
1993, R201FX DOS Global Session fixes applied). 

The CONFIG.SYS file modifications: 



f 

LI0PATH«.;C:\IBMCOK\OLL;C:\OS2\DLL;C:\OS2\MDOS;C:\;C:\OSZ\APPS\OLL;K:V*OS2\CLL;M:\0STCP288\OlljK:\NKAREZei; 
SET PATH-C:\OS2;C:VOS2\SYSTEM;K:\OS2\MQO$\WINOS2;C:\OS2\INSTALL;C:\;C:\OS2\MOOS;C:\OS2\APPS;K:\7f<OS2; 
H:\OSTCP269\BIN;K:\NWARE20!;1:\OS2;P:\OS2; 

SET DPATK-C:\I8MCOM;C:\OS2;C:\OS2\SYSTEM;K:\OS2\KQO$\WINOS2;C:\OS2\INSTALL;C:\;C:\O$2\BITKAP;C:\0S2\MD0S; 
C:\O$2\APPS;K:\WOS2;K:VttiS2\!N$TAll:K:\MUARE201;i:\OS2;P:\OS2; 

SET KEIP*C:\OS2\KELP;C:\OS2\KEIP\TUTOR1AL;K:\IMQS2\KELP;H:\OSTCP200\HELP; 

PRIORITY DISK 10-YES 
FILES-20" 

DEVICE -C:\IBKCOM\PROTOCOL\LANP0O.OS2 
DEVICE«C:\IBKCDK\PR0T0C0L\IAHVD0.0S2 
DEVICE -C:\18MC0M\LANMSG0D.0S2 /I:C:\IBKC0M 
OEVICE»C:\IBMCOM\PROTKAN.OS2 /I:C:\IB«0H 
DEVI CE-C:\0S2\TESTCF0. SYS 
OE VI CE-C t \0S2\00S . SYS 

SET BOOKSKE LF-C :\0S2\B0DK ; K : \W0S2 ;H :\0STCP288\D0C ; 

DEVI CE -K:\WQS2\A0SHDD.SYS 

DEVI CE -K:\W0S2\SHVDD . SYS 

RUN-C:\I BMC OM\PRDTOCOL\NETBINO.EXE 

RUN-C:\I BKCOMUANHSCEX.EXE 

OE VI CE-C :\I 8KC0K\PRQT0C0L\ I RET . SYS 

OE VI CE-C :\I BMC0M\PR0T0CDl\ I FKOI S .SYS 

DEVKE-C:\IBMC0M\HACS\I6MT0K.0S2 

SET ETC-H:\OSTCP20a\ETC 

SET TKP-H:\OSTCP2B0\TMP 

SET REAO18M-H:\OSTCP280\OOC 

SET HOSTNAME-oordor 

RUR-H :\0STCP289\BI M\CNTRl.EXE 

IFS*H:\OSTCP269\BIN\NFS200.IFS 

OEVICE-H:\OSTCP208\BIM\VOOSTCP.VDO 

DEVI CE«H:\0ST CP268VBI N\V00ST CP. SYS 

RUN-H:\OSTCP200\BI N\V00SCT L . EXE 

SET LIB-H:\OSTCP2B0\LIB 

SET INCLDDE*H:\0STCP2B6\IHCIUDE 

SET DISPLAY-eordortO 

SET XFI LES-H;\OSTCP209\X1 1 

SET XFIlESEARCHPATK-H:\OSTCP2e0\Xn 

SET XAPPLRESDIR-H:\OSTCP20D\X11 

SET XENV1 RCNMENT «H :\OSTCP200\ETC\Xresource 

SET XKEYSYMOB-H:\OSTCP200\XKeysyBDB 

SET TZ-est5edt 

SET NFS. PERMISSION. BITS- 70B 

SET KFS.PERMISSION.DB1TS-7G0 

SET lPR_SERVER-oordor 

SET LPR^PRINTER-Iptl 

SET USER-consorti 

SET PASSWD-orloles 

SET TELNET .PASSWORD. ID-oH ol VI 

SET NEWSSERVER-yKtntws.watson.lbv.ccv 

SET SYSCONTACT-Joe Consort! xBBZB 

SET SYSL0CATI0N-1BH Washington Systems Center 

DEVI CE-C :\I BMCOM\PROT OCOL\ LANDO. 0S2 
DEVICE -C:\IBMCOMVPROTGCOL\LANOILDQ.OS2 
RUN-C:\IBMC OM\PROTOCOL\LANDLL.EXE 

REM NetWare Requester statenents BEGIN — 

SET NWLAN6UA0E -ENGLISH 

DEVICE-K:\NWARE201\LSL.SYS 

RUN-K:\NWARE231\D0AEK0N.EXE 

DEVICE -K:\NWARE2ai\LANSUP* SYS 

OEVICE ■R:\NWARE201\ROUTE. SYS 

DEVICE -K:\NWARE20l\IPX. SYS 

DEVICE -K:\NWARE2D1\SPX. SYS 

RUN«K:\NWARE201\SPOAEMON . EXE 

rev DEVICE -K:\NWARE2BI\NMPI PE. SYS 

rev DEVICE -K:\NWARE29I\NPSERVER. SYS 

rev RUN-K:\NWARE2ai\NP0AEM0N.EXE 

DEVI CE*K:\NWARE291\KWRE0. SYS 

IFS«K:\NWARE201\NWIF$.IFS 

RUN*K:\NWARE 201\NW0AEK0N.EXE 

rev DEVICE -K:\NWARE2D1\NET0I OS. SYS 

rev RUN-N:\NWARE201 \N8DAEM0N.EXE 

DEVI CE -K:\NWARE 201\VI PX . SYS 

DEVICE -K:\NWARE 201WSHEL L . SYS PRI VATE 

REM -•* NetWare Requester statenents END ••• 

J 
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Notes: 

1. Create NET.CFG file in root directory and specify NODE ADDRESS. 

2. NODE ADDRESS usually in LSB first format unless LAN bridges are used. 

3. Manually add NetWare ROUTE.SYS statement to CONFIG.SYS for token-ring. 

The PROTOCOL.INI file: 

This is the PROTOCOL.INI file created by NTS/2 and TCP/IP LAPS. A local LAN 
adapter address was specified in MAC driver section. 



[PROT MAN] 

DRIVERNAME = PR0TMAN$ 

[IBMLXCF6] 

LANDD nif = LANDD.NIF 
TCPIPjfiif = TCPIP.NIF 
IBMTOKjrif = IBMTOK.nif 

[LANDD_nif] 

DriverName = LANDD$ 

Bindings = IBMTOK_nif 
ETHERAND TYPE = "I" 

SYSTEM_KEY = 0x0 
OPEN l_0PT IONS = 0x2000 
TRACE = 0X0 
LINKS = 8 
MAX SAPS = 3 
MAXJJAPS = 0 
USERS = 3 
TI TICK_G1 = 255 
T1JICK_G1 = 15 
T2 TICK G1 = 3 
TIJICK G2 = 255 
T1JICKJ2 = 25 
T2_TICK_G2 = 10 
IPACKETS = 250 
UI PACKETS = 100 
MAXTRANSMITS = 6 
MINTRANSMITS = 2 
TCBS = 64 
GDTS = 30 
ELEMENTS = 800 

[TCPIPjlif] 

DriverName = TCPIP$ 

Bindings = IBMTOK_nif 

[IBMTOK_nif] 

DriverName = IBMT0K$ 

ADAPTER = "PRIMARY “ 

NETADDRESS = "400012461234" 

MAXTRANSMITS = 6 
RECVBUFS = 2 
RECVBUFSIZE = 256 
XMITBUFS = 1 

V / 



The NET.CFG file: 

This is the NET.CFG file that was manually created during NetWare installation. 
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netware requester 

preferred server drumpoint 
directory services off 
packet burst off 



; Comnon to All NET. CFG Configurations 
5 NetWare 3.11 in Client/Server Lab 
5 No NetWare 4.0 Servers in the Network 
; This was REQUIRED in our Tests 



link driver lansup 
frame token-ring 
frame token-ring_snap 
node address 400912461234 



; Use Local Adapter Hardware Address 



20.3.2 TCP/IP, NetWare (LANSUP, Ethernet) 

This example was completed on a PS/2 Model 80 system with a 3Com 3C523 
EtherLink/MC adapter, running OS/2 V2.1, TCP/IP V2.0 for OS/2, NTS/2 (WR07020) 
and NetWare Workstation for OS/2 V2.01 (with Novell November 5, 1993, R201FX 
DOS Global Session fixes applied). 

The CONFIG.SYS file modifications: 
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LlBPATH-.;C:\ieMC0M\0lL;C:\0S2\DLl;C:\0SZ\MD0S;C:\;C:\0S2\APPS\BlL;H:\0STCP2M\Dll;X:\KWAR£2llj 
SET PATH-C:\OS2;C:\0$2\SYSTEMjX:\0S2\MD0S\WINQS2;Ct\0$2\tNSTALLsC:\sCi\OS2\MC0SjC:\0S2\APP$jll:\HC$2i 
H:\OSTCP208\BIN ;K;\NKARE201 s L:\0S2 ;P:\0S2; 

SET OPATH>C:\I6KCOH;C:\OS2;C:\OS2\SY$TEH;K:\OS2\HDOS\WIKOS2;C:\OS2\lN$TAiL;C:\;C:\OS2\BITMAP;C:\OS2VOOS; 
C:\OS2\APPS;K:\ff40S2;K:\fflOSZ\lNSTALi;K:\NWARE2Gl;L:\OS2;P:\OS2; 

SET HELP-C:\OS2\HELP;C:\OS2\HELP\TUTORIAl;K:\fflOS2\HELPjH:\OSTCP260\KtlP; 

PRIORITYJHSK JO-YES 
FUES-20~ 

QEVICE -C:\I6MCOM\PROTOCOL\LANPDO.OS2 
0EVICE-C:\IBMC0M\PR0T0C0L\LANVDD.0S2 
QEVICE-C:\IBNCWUAKMSGQ0.0S2 /I:C:\IBHCOH 
DEVICE»C:\16MC0M\PR0TMAN.0S2 /1:C:\18HC0M 
DEVI CE-C:\OS2\TESTCFG. SYS 
DEV1CE-C:\0S2\D0S.SYS 

SET 0OOKSHELF-C:\OS2\BOOK;X:V*«$2;H:\O$TCP2fi8\BOCj 

0EVICE»K:\W0S2\ADSHD0.$YS 

DEVI CE-K:\FM0S2\SHVD0. SYS 

RUN»C:\IBKC OM\PROTOCOl\KETBINO.EXE 

RUN«C:\IBHCOM\ LANHSGEX.EXE 

OE VI CE-C :\I BMCOHVPROT OCO L\IKET . SYS 

DEVI CE-C :\I GHCOMVPROTOCOLMFNOI S . SYS 

DEVICE ■C:\IBKC0K\MACS\ELXKMC.0S2 

SET ETC-H:\O$TCP208\ETC 

SET TMP»H:\OSTCP208\THP 

SET READ16M-H:\0STCP289\0GC 

SET HOSTRAFt-BOrtor 

RUN-M:\OSTCP208\0I N\CNTRL .EXE 

I FS-H:\OSTCP208\0I N\NFSZ88 . IFS 

DEVICE-H:\0STCP288\BmVD0STCP.V00 

DEVICE»H:\0STCP268\8IN\VD0STCP.SYS 

RUN-H;\0STCP288\BI N\VOQSCU.EXE 

SET LI8*H:\OSTCP299\LIB 

SET INCLUOE-H:\OSTCP208\INCLUDE 

SET DISPlAY-nordortfl 

SET XFILES-H:\OSTCP200\xn 

SET XFI IESEARCKPATH«H:\OSTCP200\X1 1 

SET XAPPLRESOIR-H:\OSTCP200\xn 

SET XEWVI ROWE NT •H:\OSTCP200\ETC\XrtlOurct 

SET XK£YSYMOB-H:\OSTCP208\XKeysynO8 

SET TZ-estSedt 

SET NFS.PERMISSI0N.BITS-788 

SET NFS.PERmSSlON.OaiTSWSO 

SET lPR_SERVER-*ordar 

SET LPR~PAINTER»lptl 

SET USER-Consortl 

SET PASSWO-orloltS 

SET TELNET. PASSWORD. I O-orloles 

SET NEWSSERVER-yUntwS .watson . 1 bo. coa 

SET SYSCONTACT-Jot Consort! x8B2B 

SET SYSLOCATION-I0H Washington Systems Ctntar 

QEVICE-C:\IBMCOM\PROTOCOL\LANBQ.OSZ 
DEVI CE a, C:\I BMCOM\PRQT OCO L\LANDL LOD. DS2 
RUN-C:\I0MC OM\PROTOCOL\LANDLL.EXE 

REH — NetWare R«qutst*r stateocnts BEGIN 

SET NWLANGUAGE -ENGLISH 

OEVICE ■K:\NWARE201\LSL. SYS 

RUN-K:\NWAR£ 201\ODAEHON.EXE 

DEVICE -X:\NWARE201\LANSUP. SYS 

OEVICE*K:\NWARE291\IPX.SYS 

DEVICE -K:\NWARE201\SPX. SYS 

RUN-*:\NWARE201\SPOAE«N.EXE 

ran OEVICE-K:\NWARE201\NHPIPE.SYS 

rtu DEVICE -K:\NWARE201\NPSERVER.SYS 

reo RUN-K:\NWARE201\NPDAEMDN.EXE 

0EVICE-K:\NWARE201\NVRE0.SYS 

IFS-K:\NWARE201\NVIFS.IFS 

RUN -K:\NWARE 201 \KVDAEMON . EXE 

rea DEVI CE-X:\NWARE201\NETBIOS. SYS 

reo RUN«K:\NWARE201\NBDAEKON.EXE 

DEVICE-K:\KWARE201\V1PX.SYS 

DEVI CE-K:\NWARE201\VSHELL. SYS PRIVATE 

REM --- NetWare Requester stett&ents END -- 

' 



Notes: 

1. Create NET.CF6 file in root directory and specify NODE ADDRESS. 

2. NODE ADDRESS usually in LSB first format unless LAN bridges are used. 

The PROTOCOL.INI file: 

This PROTOCOL.INI file was created by NTS/2 and TCP/IP LAPS. A local LAN 
adapter address was specified in MAC driver section. 
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[PROT HAN] 

DRIVERNAME = PROTMANJ 

[IBMLXCFG] 

LANOD nif = LANDD.NIF 
TCPIPjlif = TCPIP.NIF 
ELNKMC_nif = ELNKMC.nif 

[LANDD_nif] 

DriverName = LANOD$ 
Bindings = ELNKMC nif 
ETHERAND TYPE = "I" 

SYSTEM KEY = 0x0 
OPEN_OPTIONS « 0x2000 
TRACE « 0X0 
LINKS = 8 
MAX_SAPS * 3 
MAX G SAPS = 0 
USERS = 3 
TI TICK G1 = 255 
T1_TICK~G1 » 15 
T2 TICK_G1 = 3 
TI TICK G2 <= 255 
Tl TICKJ52 » 25 
T2~TICK G2 = 10 
IPACKETS = 250 
UI PACKETS = 100 
MAXTRANSMITS = 6 
MINTRANSMITS = 2 
TCBS = 64 
GDTS = 30 
ELEMENTS = 800 

[TCPIP_nif] 

DriverName = TCPIP$ 
Bindings » ELNKMC_nif 

[ELNKMC_ni f] 

DriverName = ELNKMC$ 
netaddress = "400012345678 H 
maxtransmits - 12 



The NET.CFG file: 



This is the NET.CFG file was manually created during NetWare installation. 



( 

netware requester 


■\ 

; Comnon to All NET.CFG Configurations 


preferred server drumpoint 


; NetWare 3.11 in Client/server Lab 


directory services off 


; No NetWare 4.9 Servers in the Network 


packet burst off 


5 This was REQUIRED in our Tests 


link support 




buffers 20 1496 


; 3Com 3C523 Adapter Max Buffer Size 1496 


link driver lansup 




frame Ethernet 802.2 


} LANSUP Requires Ethernet_802.2 Frame 


node address 400012345678 




J 
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20.3.3 TCP/IP, NetWare (ODINSUP, Token-Ring) 

This example was completed on a PS/2 Model 80 system with an IBM 
Token-Ring Network Adapter/A, running OS/2 V2.1, TCP/IP V2.0 for OS/2 and 
NetWare Workstation for OS/2 V2.01 (with Novell November 5, 1993, R201FX DOS 
Global Session fixes applied). 

When using ODINSUP with a token-ring adapter remember to: 

1. Modify PROTOCOUNI bindings statement. 

2. Remove MAC section from PROTOCOL.INI. 

3. Change order of statements in CONFIG.SYS. 

4. Add ODINSUP.SYS driver to CONFIG.SYS. 

5. Add ROUTE.SYS driver to CONFIG.SYS when using source route bridges. 

6. Remove NDIS MAC driver statement in CONFIG.SYS 

The CONFIG.SYS file modifications: 
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/ — — V 

UBPATH*.;C:\IBMCOM\OlL;C:\OS2\Ot.L;C:\OS2\MO8S;C:\;C:\OS2\APPS\BLL;K:VffOS2\QlL;H:\OSTCP260\OLL;K:\IMARE2ll; 

SET PATH«C:\OS2;C:\OS2\SYSTEH;K:\OS2\MOOS\WlNOS2;C:\OS2\INSTAll;C:\;C:\OS2\MQOS;C:\OS2\APPS;K:\)fOS2; 
H:\0STCP2G9\QI N ; X: \NWARE201 ; L :\0S2 ;P :\0S2; 

SET OPATH-C:\I0KCOM;C:\OS2;C:\OS2\SYSTEM;K:\OS2\HOOS\WKOS2;C:\OS2\INSTAlL;C:\;C:\OS2\BimAP;C:\QS2\«OSi 
C:\OS2\APPS;K:\WOS2;K:\fflQS2\lNSTALl;K:\KWAAE201;L:\OS2;P:\OS2; 

SET HElP-C:\0$2\HELP;C:\0S2\WELP\TUT0RIAl;K:\moS2\HELP;H:\0STCP289\NElP; 

SET BOOKSHE L F • C ;\OS2\BOOX;K :\WOS2: H:\OSTCP280\OOC ; 

DEVI CE *K : \W0$2\A0SKD0 . SYS 
BEVICE*K:\t*0S2\SWB0.$YS 

REM NttWart Requester statements BEGIN 
SET NVIANGUACE-ENGUSH 
OEVICE •K:\KVARE281\lSl. SYS 
RUN*K:\NUAR£?01 \DDAEKON.EXE 
GEVICE*K:\NWARE201\TBXEN.SY$ 

DEVICE •K:\RKARE291\R0UTE. SYS 

DEVICE*K:\NWARE281\IPX.SYS 

DEVI CE«K:\KKARE281\SPX. SYS 

RUN- K:\KWARE201\SPDAEMCN.EXE 

rtn BE VICE -K:\NWARE201\NMPI PE. SYS 

ren DEVICE -K:\NVARE281\NPSERVER. SYS 

ren RUN-K:\KWARE291\NPDAEK0N.EXE 

BEVlCE-K:\WiARE281\KWRE0.SYS 

I FS* K:\NWARE2B1\NWIFS. IPS 

RUN- H:\KWARE291\KVOAEMON.EXE 

ren OE VICE* K:\NUARE201\NET0I OS. SYS 

ren RUN-IC\NWARE2ei\NB0AEM0N.EXE 

OE VI CE-X:\NWARE2fll\Vl PX . SYS 

0EVICE*«:\NWARE281\VSHElt.SYS PRIVATE 

REH ••• NetWare Requester statements END — 

0EVICE»C:\IBMC0MUANM$CBD.0S2 /I :C:\IBMC0M 

DEVI CE «C s\I BMCOM\PRQTKAN . 0S2 / 1 : C :\I BMCOM 

DEVICE-K:\NVARE201\OOINSUP.SVS 

OE VICE •C:\IBMCGM\PROTOCOL\ I NET. SYS 

OEVICE*C:\I8MCOM\PROTOCOL\IFNOIS.SYS 

RUN*C:\I BMCOM\PROTOCOL\NETBI NO . EXE 

RVN-C :\I BMC0MUAXMS6EX. EXE 

SET ETC*H:\0STCP2S8\ETC 

SET TKP»H:\0STCP288\TMP 

SET RE AOI BM*H :\0STCP269\00C 

SET HOSTNAME -eordor 

RUN-H : \0STCP288\B1 N\CNTRl. EXE 

IFS a H:\OSTCP288\BlN\NFS268*IFS 

OEVICE* H:\0STCP288\BIN\VD0STCP.VD0 

OE VI CE ■H:\O5TCP280\BI N\VBOST CP . SYS 

RDN-H :\OST CP268XB1 NWOOSCT L . EXE 

SET II0«H:\OSTCP280\LIB 

SET 1NCIUDE*H:\0STCP268\INCIUBE 

SET DISPLAY>nordor:8 

SET XFI IES“H:\0$TCP288\X11 

SET XFILESEARCHPATH-H:\OSTCP2B0\X11 

SET XAPPIRESO2R«H:\OSTCP200\XU 

SET XENVI RONMENT -H:\OSTCP208\ETC\Xresource 

SET XK£YSYMO8*H:\OSTCP200\XKeysyvfi9 

SET T2*est5edt 

SET NFS. PERMI SSI ON. BITS* 780 

SET NFS. PERMISSION. OBI TS-708 

SET lPR_SERVEfl-w>rdor 

SET IPR_PR1NTER-Iptl 

SET USER-consortl 

SET PASSWO-oHoles 

SET TELNET.PASSV0R0.10*orfoles 

SET KEWSSERVER-yktnews. wetson. 1 ba.coa 

SET SYSCONTACT-Joe Consorti x882B 

SET SYSLOCATION«IW Washington Systeas Center 

V — / 



Notes: 

1. Requires lots of manual changes to CONFIG.SYS and PROTOCOLING 

2. Backup CONFIG.SYS and PROTOCOL.INI files before NetWare installation. 

3. Install TCP/IP before NetWare. 

4. Manually create NET.CFG File in root directory. 

5. After NetWare installation, modify CONFIG.SYS and PROTOCOLING 

6. Follow the order of the drivers shown at the CONFIG.SYS example. 

7. Reboot your system. 

The PROTOCOL.INI file: 
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This is the PROTOCOL.INI file created by TCPLAPS installation and configuration, 
with the manual changes for ODINSUP support. 



[PROT MAN] 

DriverName * PROTMAN) 


\ 


[IBMLXCFG] 

TCPIP_nif = TCPIP.nif 




[TCPIPjlif] 
DriverName = TCPIP$ 

Bindings = TOKEN 
V 




The NET.CFG file: 




This is the NET.CFG file that was manually created during NetWare installation. 

A local LAN adapter MAC address was specified in the NET.CFG file to override 
the IEEE universal address. The PROTOCOL ROUTE definitions were required to 
provide source route support for both frame types. IPX defaults to Token-Ring 
and TCP/IP requires Token-Ring_SNAP. 


/ 

netware requester 

preferred server drumpoint 
directory services off 
packet burst off 


5 Common to All NET.CFG Configurations 
; NetWare 3.11 in Client/Server Lab 
; No NetWare 4.0 Servers in the Network 
; This was REQUIRED in our Tests 


protocol odinsup 
bind token 


; IBM Token-Ring Driver 


protocol route 

source route board 1 
source route board 2 


; Add for Token-Ring Source Route Support 
; This is the Default with ROUTE. SYS 
; Required for Token-Ring_SNAP Frame 


link support 
buffers 29 1514 


; Default Values, Use 14 4216 for IBM 4/16 Mbps 
; Token-Ring Adapters Supporting 4K Frame Sizes 


link driver token 
frame token-ring 
frame token-ring snap 
node address 406612461234 


; Use Local Adapter Hardware Address 




J 



20.3.4 TCP/IP, NetWare (ODINSUP, Ethernet) 

This example was completed on a PS/2 Model 80 system with a 3Com 3C523 
EtherLink/MC adapter, running OS/2 V2.1, TCP/IP V2.0 for OS/2 and NetWare 
Workstation for OS/2 V2.01 (with Novell November 5. 1993, R201FX DOS Global 
Session fixes applied). When using ODINSUP remember to: 

1. Modify PROTOCOL.INI bindings statement. 

2. Remove MAC section from PROTOCOL.INI. 

3. Change order of statements in CONFIG.SYS. 

4. Add ODINSUP.SYS driver to CONFIG.SYS. 

5. Remove NDIS MAC driver statement in CONFIG.SYS. 

The CONFIG.SYS file modifications: 
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LI6PATH- . }C :\I 0MCOM\Ot L { C :\OS2\OL L;C:\0S2\HD0$;C:\;C :\0S2\APPS\Dtl;H:\0$TCP268\DU ;X:\NWARE281 ; 

SET PATH*C:\OS2;C:\DS?\SYSTEM;K:\OS2\MOOS\wiKOS2;C:\OS2\IHSTALL;C:\;Ct\OS2\MODS;C:\OS2\APPS:K:\mo$2; 
H:\0STCP288\BI N; K:\NWARE28I ; L :\0S2 ;P:\OS2 ; 

SET OPATH*C:\IBMCOM;C:\0$2:C:\0$2\SVSTEM;K:\OS2\MOQS\WlKO$2:C:\OS2\lNSTAlljC:\iC:\OS2\BITNAP;C:\OS2\*OS; 
C:\OS2\APPS;K:\*fOS2;X:\fflOS2\INSTAU;it:\NMAR£201;l:\OS2:P:\OS2; 

SET KELP a C:\OS2\KELP;C:\OS2\KElP\TUTQRlAL;K:\Ft<OS2\KELP;H:\OSTCP268\HElP; 

SET BOOKSHE LF-C :\0S2\B00X; N:\WtQS2; H:\0STCP2G8\00C ; 

DEVI CE B X:\*<OS2\AOSHDO. SYS 
DEVI CE a K:\tM)S2\SMVOO. SYS 

REM — NttWart R*<j-«st»r itatiatnts BEGIN — 

SET NWLANGUAGE’ENGLISH 
QEVICE a K:\XWARE201\LSl.SYS 
RUN •X:\NWARE281 \OOAEMON . EXE 
DEVICE •K:\KUARE201\3C523.SYS 
DEVICE •K:\NWARE2G1\IPX. SYS 
0EVlCE a K:\NVARE281\SPX.$Y$ 

RUN a K:\NUARE281\SPDA£M0N.£XE 

na 0EVICE-X:\nMRE28I\)M>lPE.SYS 

ran DEVICE ■K:\NUARE281\NPSERVER. SYS 

rta RUN-K:\MMR£281\NPOAEKON.EXE 

DEVICE •K:\NUARE281 \NUREQ. SYS 

I FS» X:\NKARE201\NWIFS.IFS 

RUX a K:\NKARE281\NWOAEKON.EXE 

rta DEVICE 'K:\NWARE 201\NET0IOS. SYS 

rta RUN«X:\NWARE281\NB0AEM0N.EXE 

DEVICE ■X:\NWARE281\VIPX. SYS 

DEVICE •K:\KWARE261\VSHELL. SYS PRIVATE 

REM --- NitWsrt Rtoutsttr stattatnts END — 

OEVICE-C:\1BMCOK\LANKSGDD.OS2 /1:C:\IBMCCM 
OEVICE-C:\IBMCOM\PROTMAN.OS2 /I:C:\I0HCOM 
DEVI CE*Kt\NUARE291\0DlNSUP. SYS 
DEVICE •C:\IBMCOK\PROTOCOL\IKET. SYS 
DEVI CE-C :\I BMCOM\PROTOCOl\I FKOI S. SYS 
RUN a C:\IBHC0MV»R0T0C0l\N£T8IND.EX£ 

RUN a C:\IBKC OKU ANMS6EX.EXE 

SET ETC-H:\0STCP2G8\ETC 

SET THP ■ H : \ OST CP288\TMP 

SET REA0IBK«H:\0STCP288\D0C 

SET MOSTNAME-aordor 

RUN»H:\OSTCP290\BI N\CNTRL.EXE 

IFS a H:\DSTCP208\BIN\KFS288.IFS 

OEVICE- H:\0STCP288\BIN\V00STCP.V00 

OEVICE •H:\0STCP2B8\BIN\V00STCP. SYS 

RU K a H :\ OST CP2B8\ BI NWDOSCT L . E XE 

SET Lie>H:\OSTCP288\LIB 

SET INCLUDE<H:\0STCP288\INCIU0E 

SET OISPlAY-tordorsG 

SET XF I LES*H:\0STCP268\Xi 1 

SET XFIIESEARCKPATH-H :\0$TCP2G9\X1 1 

SET XAPPlRESDI R a H:\0STCP268\Xl I 

SET XENVI R0NMENT a Hi\0STCP2B8\ETC\XrtMurct 

SET XKEYSYM0B-H:\0STCP288\XKty*y»CB 

SET TZ*lSt5tdt 

SET NFS.PERMISSIQX.BITS a 7G8 

SET NFS. PERMISSION. OBITS* 788 

SET LPR.SERVER-aordor 

SET LPRJ>RlNT£R a lptl 

SET USER*COn»orti 

SET PASSVD-oHoltt 

SET TELNET .PASSWORD. IO a ort ol ts 

SET NEWSSERVER*yXtntws.watsan.1ba.coa 

SET SYSCONTACWot Consort I *8020 

SET SYSLOCATION-IBM Washington Systtas Ctnttr 



Notes: 

1. Requires lots of manual changes to CONFIG.SYS and PROTOCOL.INI flies. 

2. Backup the CONFIG.SYS and PROTOCOL.INI files before NetWare 
installation. 

3. Install TCP/IP before NetWare. 

4. Manually create NET.CFG file in a root directory. 

5. After NetWare Installation, modify CONFIG.SYS and PROTOCOL.INI files. 
Reboot your system. 

6. Follow the order of drivers in CONFIG.SYS example. 

7. Reboot your system. 
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The PROTOCOL.INI file: 



This is the PROTOCOL.INI file created by TCPLAPS installation and configuration, 
with the manual changes for ODINSUP support. Note that an "x" is required 
before the 3C523 ODI driver name in the Bindings parameter, since 3C523 starts 
with a number. 



— 
[PROT MAN] 

DriverName = PR0TMAN$ 


— 


[IBMLXCFG] 

TCPIP_nif = TCPIP.nif 




[TCPIPjiif] 
DriverName = TCPIP$ 
Bindings = x3C523 




The NET.CFG file: 




This is the NET.CFG file that was manually created during NetWare installation. A 
local LAN adapter MAC address was specified in the NET.CFG file to override 
the IEEE universal address or "burned-in" address. 


/ 

netware requester 

preferred server drumpoint 
directory services off 
packet burst off 


\ 

5 Contnon to All NET.CFG Configurations 
5 NetWare 3.11 in Client/Server Lab 
5 No NetWare 4.0 Servers in the Network 
; This was REQUIRED in our Tests 


protocol odinsup 
bind 3c523 


5 3Com 3C523 Driver 


link support 

buffers 20 1514 


; Default Values, Use 15 2800 for Ethernet 
; Adapters Supporting 4K Frame Sizes 


link driver 3c523 

frame Ethernet_802.3 
frame Ethernet_802.2 
frame Ethernet_II 
frame Ethernet_SNAP 
node address 400012345678 


; Use Local Adapter Hardware Address 




J 
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Appendix A. Configuration Listings for OS/2 and DOS Hosts 



This appendix lists the configuration files of the OS/2 and DOS systems that were 
used for the scenarios described throughout this document. 



A.1 Configuration Files for Host CIDSERVER 

The following configuration was used for that system: 



Table 22. System Unit and Installed Software Products for Host CIDSERVER 


Hardware 


Software 


Functions 


IBM PS/2 80-311 
10MB Memory 
Token-Ring Adapter/A 


OS/2 2.1 

TCP/IP V2.0 for OS/2 
OS/2 LAN Server V3.0 


Telnet server 
FTP server 
REXEC server 
RSH server 
NFS server/client 
Domain name server 
Code server for CID 
BOOTPD server 
TCP/NetBIOS 
LAN Server 



CONFIG.SYS File 

I FS=C : \0S2\HPFS . I FS /CACHE: 1024 /CRECL:4 /AUTOCHECK: CD 

PR0TSHELL=C:\0S2\PMSHELL. EXE 

SET USER I MI=C : \0S2\0S2 . INI 

SET SYSTEM_INI=C:\0S2\0S2SYS. INI 

SET 0S2_SHELL=C:\0S2\CMD. EXE 

set restartobjects=startupfol dersonly 

SET AUTOSTART=PROGRAMS , TASKL I ST , FOLDERS , CONNECT I ONS 

SET RUNWORKPLACE=C : \0S2\PMSHELL . EXE 

SET C0MSPEC=C: \0S2\CMD.EXE 

LIBPATH=C:\NETBI0S2;C:\IBMC0M\DLL;C:\MUGLIB\DLL;D:\IBMLAN\NETLIB;.; 

C : \0S2\DLL ; C : \OS2\MDOS ; C : \ ; C : \0S2\APPS\DLL ; D : \TCPI P\DLL ; 

SET PATH=D : \I BMLAN\NETPROG ; C :\MUGLIB; C:\0S2 ; C : \0S2\SYSTEM ; 

C : \0S2\MD0S\WI NO S2 ; C : \0S2\ I MS T ALL ; C : \ ; C : \0S2\MD0S ; 

C : \0S2\APPS ; D : \TCPI P\BI N; 

SET DPATH=C:\IBMCOM;D:\IBMLAN\NETPROG;D :\IBMLAN; C:\MUGLIB; C :\0S2; 

C : \0S2\S YST EM ; C : \0 S2\MDS\WI N0S2 ; C : \0S2\ I NST ALL } C : \ ; 

C : \0S2\B I TMAP ; C : \0S2\MD0S ; C : \0S2\APPS j c : \SERVER ; 

SET PR0MPT=$i [$p] 

SET HELP=C:\0S2\HELP; C:\0S2\HELP\TUT0RI AL;D:\TCPIP\HELP; 

SET GLOSSARY=C :\0S2\HELP\GL0SS ; 

SET IPF_KEYS=SBCS 
PRIORITY DISK I0=YES 
FILES=20 _ 
autofail =yes 
pauseonerror=no 

DEVI CE=C : \ I BMC0M\PR0T 0C0 L\LANPDD . 0S2 

DEVICE=C:\IBMCOM\PROTOCOL\LANVDD.OS2 

DEVICE=C:\IBMC0M\LANMSGDD.0S2 /I :C:\IBMC0M 

DEVICE=C:\IBMC0M\PR0TMAN.0S2 /I:C:\IBMC0M 

DEVICE=C:\0S2\TESTCFG.SYS 

DEVI CE=C : \0S2\D0S . SYS 

DEVICE=C:\0S2\PMDD.SYS 
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BUFFERS=30 

IOPL=YES 

DISKCACHE=64,IW 

MAXWAIT=3 

MEMMAN=SWAP, PROTECT 
SWAPPATH=D : \swapper 2048 3072 
BREAK=OFF 
THREA0S=256 

PRINTM0NBUFSIZE=134,134,134 
COUNTRY=001, C:\0S2\SYSTEM\C0UNTRY. SYS 
SET KEYS°ON 

REM SET DELDIR=C:\DELETE,512;D:\DELETE,512; 

BASEDEV=PRINT02.SYS 

BASEDEV= I BM2FLPY . ADD 

BASEDEV- I BM2ADSK . ADD 

BASEDEV-0S2DASD . DMD 

SET BOOKSHELF=D : \ I BMLAN\BOOK ; C : \0S2\B00K ; D : \TCPI P\DOC 
SET EPMPATH=C : \0S2\APPS ; 

REM DEVI CE=C : \0S2\APPS\SASYNCDB . SYS 
PROTECTONLY=NO 

SHELL=C : \0S2\MD0S\C0MMAND . COM C : \0S2\MD0S 

FCBS=16,8 

RMSIZE=640 

DEV I CE=C : \0S2\MD0S\VEMM . SYS 
DOS-LOW, NOUMB 

DEVICE=C : \0S2\MD0S\VDPX . SYS 

DEV I CE=C : \OS2\MDOS\VXMS . SYS /UMB 

DEVICE=C:\0S2\MD0S\VDPMI.SYS 

DEVICE=C:\OS2\MDOS\VCDROM.SYS 

DEV I CE=C : \OS2\MDOS\VW I N . S YS 

DEVICE=C:\0S2\APM.SYS 

DEVICE=C:\OS2\MDOS\VAPM.SYS 

DEV ICE=C : \0S2\PCMC IA. SYS 

DEV I CE=C : \0S2\MD0S\VPCMC I A . SYS 

DEV I C E=C : \0S2\MD0S\VM0USE . SYS 

DEVICE=C:\OS2\POINTDD.SYS 

DEVICE=C:\OS2\MOUSE.SYS 

DEVICE=C:\0S2\C0M.SYS 

DEV I CE=C : \0S2\MD0S\VC0M . SYS 

CODEPAGE=437,850 

DEVI MFO=KBD, US , C:\0S2\KEYB0ARD.DCP 
DEVINFO=SCR, VGA, C:\0S2\VI0TBL.DCP 
SET V I DEO_DEV I CES=V I 0_VGA 
SET VIO VGA=DEV ICE (B VHVGA) 

D EV I CE=C : \0S2\MD0S\V VGA .SYS 

RUN=C : \IBMCOM\PROTOCOL\NETBI ND. EXE 

RUN=C : \ I BMCOM\LANMSGEX . EXE 

DEVICES :\IBMC0M\MACS\IBMT0K.0S2 

RUN=C:\IBMCOM\PROTOCOL\LANDLL. EXE 

RUN=D :\I BMLAN\NETPROG\LSDAEMON . EXE 

RUN=C:\0S2\SYSTEM\L0GDAEM. EXE 

RUN=C:\0S2\EPW. EXE 

RUN=C : \0S2\EPWR0UT . EXE 1 

DEVI CE=C : \0S2\L0G .SYS 

DEVICE=D:\IBMLAN\NETPR0G\VNETAPI.0S2 

RUN=D : \ I BMLAN\NETPROG\VNRM I N I T . EXE 

DEV ICE=C : \NETB I 0S2\NBDRI VER . SYS -s 40 -c 95 -n 21 

DEVICE=C : \ I BMCOM\PROT OCOL\ I NET . SYS 

DEVICE=C:\IBMCOM\PROTOCOL\IFNDIS.SYS 



364 



TCP/IP V2.0 tor OS/2 




DEVI CE=D : \ I BMLAN\NETPROG\RDRHELP . 200 

DEVI CE=C : \ I BMCOM\PROT OCOL\NETBEU I . 0S2 

I FS=D: \I BMLAN\NETPROG\NETWKSTA. 200 /I:D:\IBMLAN /N 

rem DEVICE=C:\IBMCCM\PROTOCOL\NETBIOS.OS2 

DEV I CE=C : \ I BMCOM\PROTOCOL\LANDD . 0S2 

DEV I CE=C : \ I BMCOM\PROTOCOL\LANDLLDD . 0S2 

SET ETC=D:\TCPIP\ETC 

SET TMP=D:\TCPIP\TMP 

SET READIBM=D:\TCPIP\DOC 

SET HOSTNAME=ci dserver 

RUN=D : \TCP I P\B I N\CNTRL . EXE 

IFS=D:\TCPIP\BIN\NFS200. IFS 

DEVICE=D:\TCPIP\BIN\VDOSTCP.VDD 

DEV ICE=D: \TCPI P\B I N\VDOSTCP. SYS 

RUN=D : \TCPI P\BI N\VDOSCTL. EXE 

SET LIB=D:\TCPIP\LIB 

SET I NCLUDE=D : \TCPI P\I NCLUDE 

SET DISPLAY=ci dserver: 0 

SET XFILES=D:\TCPIP\X11 

SET TZ=est5edt 

SET NFS. PERMISSION. BITS=700 

SET NFS. PERMISSION. DBITS=700 

SET XFILESEARCHPATH=d:\tcpi p\Xll 

SET XAPPLRESDIR=d:\tcpip\Xll 

SET XEN V I R0NMENT=d : \tcpi p\ETC\Xresource 

SET XKEYSYMDB=d:\tcpi p\XKeysymDB 

STARTUP.CMD File 

call d:\tcpip\bin\tcpstart.cmd 

START -NetBIOS/2- c:\netbios2\NBTCP -d 9.67.38.115 9.67.38.127 

net start server 

EXIT 

PROTOCOL.INI File 

[PR0T_MAN] 

DRIVERNAME = PROTMAN$ 

[IBMLXCFG] 

LANDD nif = LANDD.NIF 
NETBEUI nif = NETBEUI. NIF 
TCPIP nif = TCPIP.nif 
IBMT0K_ni f = IBMTOK.nif 

[LANDD_nif] 

DriverName = LANDD$ 

Bindings = IBMTOK_nif 
ETHERAND_TYPE = "I" 

SYSTEM_KEY = 0x0 
OPEN_OPTIONS = 0x2009 
TRACE = 0x0 
LINKS <= 20 
MAX_SAPS = 3 
MAX_G_SAPS = 0 
USERS = 3 
TI TICK_G1 = 255 
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T1 TICK_G1 - 15 
T2~TICK_G1 o 3 
TI_TICK_G2 = 255 
T1_TICK_G2 = 25 
T2_TICK_G2 = 10 
I PACKETS = 250 
UIPACKETS = 100 
MAXTRANSMITS = 6 
MINTRANSMITS = 2 
TCBS = 64 
GDTS = 30 
ELEMENTS = 800 

[NETBEUI_nif] 



DriverName = netbeui$ 
Bindings = IBMTOK_nif 
ETHERANDJYPE = "I* 
USEADDRREV - -YES" 
0S2TRACEMASK = 0x0 
SESSIONS = 50 
NCBS = 95 
NAMES ■ 21 
SELECTORS = 5 
USEMAXDATAGRAM = "NO" 
ADAPTRATE - 1000 
WINDOWERRORS = 0 
MAXDATARCV = 4168 
TI = 30000 
T1 = 500 
T2 = 400 
MAXIN = 1 
MAXOUT » 1 

NETBIOSTIMEOUT = 500 
NETBIOSRETRIES = 8 
NAMECACHE = 0 
PIGGYBACKACKS = 1 
DATAGRAMPACKETS = 2 
PACKETS = 350 
LOOPPACKETS = 1 
PIPELINE = 5 
MAXTRANSMITS = 6 
MINTRANSMITS = 2 
DLCRETRIES = 5 

[NetBIOS_nif] 



DriverName = NETBIOSS 
Bindings = IBMTOK_nif 

[TCPIP_nif] 

DriverName = TCPIPS 
Bindings = IBMTOK_nif 

[IBMTOK_ni f] 

DriverName = IBMTOK$ 
ADAPTER = "PRIMARY" 
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NETADDRESS = *400040016003" 

MAXTRANSMITS = 12 
RECVBUFS = 10 
RECVBUFSIZE = 256 
XMITBUFS = 2 

SETUP.CMD File 

route -fh 
arp -f 

ifconfig lan0 9.67.38.115 netmask 255.255.255.192 

REM ifconfig lanl 

REM ifconfig lan2 

REM ifconfig lan3 

REM ifconfig si 

route add subnet 9.67.38.0 9.67.38.90 1 
route add subnet 9.67.212.0 9.67.38.90 2 
route add subnet 9.67.32.64 9.67.38.75 1 
route add subnet 9.67.32.0 9.67.38.81 1 
route add default 9.67.38.65 1 

TCPSTART.CMD File 

Gecho off 

echo CONFIGURING TCP/IP 

CALL D:\TCPIP\BIN\SETUP.CMD 

echo FINISHED CONFIGURING TCP/IP 



echo STARTING THE TCP/IP PROCESSES 

start inetd 

echo I NET Daemon Started 

REM start telnetd 

REM echo TELNET Daemon Started 

REM start ftpd 

REM echo FTP Daemon Started 

REM start tftpd 

REM echo TFTP Daemon Started 

REM start REXECD 

REM echo REXEC Daemon Started 

REM start rshd 

REM echo RSH Daemon Started 

REM start Ipd 

REM echo LP Daemon Started 

REM start pmx -nocopyright 

REM echo X System Server Started 

REM start talkd 

REM echo TALK Daemon Started 

start portmap 

echo Portmapper Started 

start nfsd 

echo Network File System Server Started 

call nfsstart 

echo Network File System Client Started 

REM start routed 

REM echo ROUTED Started 

REM start sendmail -bd -q30m 

REM echo SENDMAIL Started 

REM start nr2 
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REM echo NR2 Started 

REM detach lprportd 

REM echo LPRPORTD Started 

start named 

echo Domain Name Server Started 

start bootpd 

echo BOOTP Server Started 

echo FINISHED STARTING THE TCP/IP PROCESSES 

IF EXIST D:\TCPIP\BIN\TCPEXIT.CMD CALL TCPEXIT.CMD 
echo EXITING TCPSTART.CMD 



INETD.LST File 

telnet tcp telnetd 
ftp tcp ftpdc 
exec tcp REXECD 
shell tcp rshd 



HOSTS Files 



9.67.38.115 

9.67.38.81 

9.67.38.106 

9.67.38.65 

9.67.38.70 
9.67.38.69 
9.67.38.75 
9.67.38.126 
9.67.38.83 
9.67.38.90 

9.67.32.71 
9.67.212.9 



cidserver 

martin 

miers 

wtcesa 

osx25 

os25 

rs60007 

murphy 

ralyas4b 

routx25 

dec 

sun 



RESOLV Files 

domain itsc.ra1eigh.ibm.com 
nameserver 9.67.38.115 



TRUSERS File 

user: martin martin 
rd: c:\ d:\ 
wr: c:\ d:\ 
user: anonymous 
rd: d:\tcpip\tmp 

EXPORTS File 

#D I RECTORY CLIENTS COMMENT 

d:\cid -ro 

#read-only to everyone 

d:\doc osx25 miers martin os25 cidserver routx25 install 
#Dir for storing documents 

d:\too1s osx25 miers martin os25 cidserver routx25 install 
#Dir for storing tools 

d:\book osx25 miers martin os25 cidserver routx25 install 
#Dir for storing books 

NAMED.BT File 
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NAMED. BT file for name server configuration 



; type 


domai n 


source file or host 


) 

domain 


itsc.ra1eigh.ibm.com 




i 

jcache 


• 


d : \\tcpi p\\etc\\namedb\\named . ca 


» 

primary 


itsc.raleigh.ibm.com 


d : \\tcpi p\\etc\\namedb\\named . dom 


i 

primary 


64.38.67.9.in-addr.arpa 


d : \\tcpi p\\etc\\namedb\\named . rev 



secondary sna1ink.raleigh.ibm.com 9.67.32.1 d:\\tcpip\\etc\\namedb\\named.sac 



NAMED, DOM File 



{ORIGIN itsc.ra1eigh.ibm.com. 



******************************** 

* Start of Authority Records * 
******************************** 



IN SOA cidserver.itsc.raleigh.ibm.com. nsadmin.itsc.raleigh.ibm.com. ( 
93652601 ; Serial number for this data (yymrndd##) 

86406 } Refresh value for secondary name servers 

300 } Retry value for secondary name servers 

864000 } Expire value for secondary name servers 

3600 ) ; Minimum TTL value 



9 IN NS cidserver.itsc.ra1eigh.ibm.com. 



******************************** 

* Domain Address Information * 
******************************** 



1 

cidserver 


86400 


IN 


A 


9.67.38.115 






IN 


HINFO 


IBM-PS/2 80, OS/2 2.1 






IN 


WKS 


9.67.38.115 tcp ftp telnet 






IN 


WKS 


9.67.38.115 udp echo sunrpc 






IN 


TXT 


"ITSC LAB" 


i 

martin 


86460 


IN 


A 


9.67.38.81 






IN 


HINFO 


IBM-PS/2 80, OS/2 2.1 


i 

miers 


86406 


IN 


A 


9.67.38.106 






IN 


HINFO 


IBM-PS/2 80, OS/2 2.1 


> 

murphy 


86406 


IN 


A 


9.67.38.126 


os25 




IN 


HINFO 


IBM-PS/2 80, OS/2 2.1 


86466 


IN 


A 


9.67.38.69 






IN 


HINFO 


IBM-PS/2 80, OS/2 2.1 


1 

routx25 


86460 


IN 


A 


9.67.38.96 






IN 


HINFO 


IBM-PS/2 80, OS/2 2.1 


i 

dos20 


86400 


IN 


A 


9.67.38.68 
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IN HINFO IBM-PS/2 76, DOS 5 



> 



osx25 


86460 


IN 


A 


9.67.38.76 






IN 


HINFO 


IBM-PS/2 80, OS/2 2.0 


* 

rs60007 


86466 


IN 


A 


9.67.38.75 






IN 


HINFO 


IBM RS/6666, AIX 3.2 


1 

ralyas4a 


86460 


IN 


A 


9.67.38.82 






IN 


HINFO 


IBM AS/400, V3R1 


S 

ralyas4b 


86400 


IN 


A 


9.67.38.83 






IN 


HINFO 


IBM AS/400, V3R1 


s 

wtcesa 


86400 


IN 


A 


9.67.38.65 






IN 


HINFO 


IBM ES/9666, VM ESA 



> 



NAMED. REV File 

5 

$0RIGIN 38.67.9.in-addr.arpa. 

I 

********************************* 

I 

;* Start of Authority Records * 

• *********************** ********* 
f 

> 

@ IN SOA cidserver.itsc.raleigh.ibm.com. nsadmin.itsc.raleigh.ibm.com. 

93652691 j Serial number for this data (yymmdd##) 

86460 ; Refresh value for secondary name servers 

300 ; Retry value for secondary name servers 

864000 j Expire value for secondary name servers 
3600 ) ; Minimum TTL value 

6 IN NS cidserver.itsc.raleigh.ibm.com. 

i 



115 


IN 


PTR 


ci dserver . i tsc . ral ei gh . i bm.com. 


81 


IN 


PTR 


marti n. i tsc. ral ei gh . i bm. com. 


106 


IN 


PTR 


mi ers . i tsc . ral ei gh . i bm.com. 


126 


IN 


PTR 


murphy. i tsc. ral ei gh . i bm. com. 


68 


IN 


PTR 


dos26.itsc.raleigh.ibm.com. 


69 


IN 


PTR 


os25.itsc.raleigh.ibm.com. - 


76 


IN 


PTR 


osx25.itsc.raleigh.ibm.com. 


96 


IN 


PTR 


routx25 . i tsc . ral ei gh . i bm. com. 


75 


IN 


PTR 


rs60007 . i tsc . ral ei gh . i bm. com. 


82 


IN 


PTR 


ral yas4a . i tsc . ral ei gh . i bm. com. 


83 


IN 


PTR 


ral yas4b . i tsc . ral ei gh . i bm. com. 


65 


IN 


PTR 


wtcesa. i tsc. ral ei gh . i bm. com. 



BOOTPTAB File 

If \tcpip\etc\bootptab: database for bootp server BOOTPD 

# Blank lines and lines beginning with are ignored. 

# 

# Legend: 

# 

# first field — hostname 

# (full domain name) 

# 



370 TCP/IP V2.0 tor OS/2 




# bf — bootfile (not supported) 

# ds — domain name server address list 

# gw — gateway address list 

§ ha — host hardware address (follows ht) (hexadecimal) 

# hd — home directory (not supported) 

# hn — send host name (boolean tag) 

# ht — host hardware type (precedes ha) (ethernet, ether) 

# ip — host IP address 

# sm — subnet mask 

# tc — template host (points to similar host entry) 

a 

# Be careful about including backslashes where they're needed. 

# Strange things can happen when a backslash is 

# omitted where one is intended. 

# 



# First, we define a global entry which specifies the info every 

# host uses. 

global .dummy:\ 

: sm=255 . 255 . 255 . 192 : \ 

:hd=/bootpd/trypd:bf=nul 1 :\ 

:ds=9. 67.38. 115: 

# Next, the subnets information. 

subnet38.dummy:\ 

:tc=global .dummy:gw=9.67.38.69 
subnet32. dummy :\ 

:tc=global .dummy:gw=9.67.32.68 

# Last, the individual information. 

ci dserver . i tsc . ral ei gh . i bm. com: tc=subnet38. dummy: ht=ethernet :\ 

ha=40004001O003: ip=9.67.38. 115: hn: 
dos20.itsc.raleigh.ibm.com: tc=subnet38. dummy: ht=ethernet:\ 

ha=10005a26399c: i p=9.67. 38.68: hn: 

os25.itsc.raleigh.ibm.com: tc=subnet38. dummy: ht=ethernet:\ 
ha=4000300 10002: ip=9. 67. 38.69: hn: 
os25e.itsc.raleigh.ibm.com: tc=subnet 32. dummy: ht=ethernet:\ 

ha=10005a8258de: ip=9.67.32.68: hn: 

IBMLAN.INI File 

; OS/2 LAN Server initialization file 
[networks] 

netl = NETBEUI}, 0,LM10, 32, 50, 14 
net2 = NETBIOS}, 0,NB30, 32, 50, 14 

5 This information is read by the redirector at device initialization time, 
[requester] 

COMPUTERNAME = WTRNBSRV 
DOMAIN = WTRNBTCP 

; The following parameters generally do not need to be 
5 changed by the user. 
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charcount ■ 16 
chartime = 250 
charwalt = 3600 
keepconn ** 600 
keepsearch = 600 
maxcmds = 16 
maxerrorlog » 100 
maxthreads = 10 
maxwrkcache = 64 
numalerts » 12 
numcharbuf ■ 10 
numservices » 16 
numworkbuf = 15 
numdgrambuf = 14 
othdomains = 
prlntbuftlme = 90 
sesstlmeout = 45 
sizcharbuf = 512 
sizerror «■ 1024 
sizworkbuf = 4096 

; The next lines help you to locate bits in the wrkheuri sties entry. 

; 12 3 

} 0123456789012345678901234567890123 

wrkheuri sties = 1111111121311111110001011120111221 
WRKSERVICES = LSCLIENT, MESSENGER, NETPOPUP 
wrknets = NET1.NET2 

[messenger] 

logfile = messages.log 
sizmessbuf = 4096 

[lsclient] 

multi logon *= yes 
timesync ° yes 
logonverifi cation = domain 
logonwarningmsgs = all 

[netlogon] 

SCRIPTS = D:\IBMLAN\REPL\IMPORT\SCRIPTS 
pulse » 60 
update = yes 

[replicator] 

replicate = IMPORT 

IMPORTPATH ■= O:\ibmlan\repl\import 

tryuser = yes 

password » 

interval = 5 

guardtime = 2 

pulse ° 3 

random ° 60 

[dcdbrepl ] 
tryuser ■» yes 
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password * 
interval a 5 
guardtime ® 2 
pulse = 3 
random - 60 

[server] 

alertnames = 
auditing = yes 
autodisconnect = 120 
maxusers = 32 

; The following parameters generally do not need to be 
; changed by the user. NOTE: srvnets= is represented in 
j the server info struct as a 16-bit lan mask. Srvnet names 
; are converted to indexes within [networks] for the named nets, 
guestacct = guest 
accessalert * 5 
alertsched « 5 
diskalert = 5000 
erroralert = 5 
logonalert «* 5 
maxauditlog = 100 
maxchdevjob = 6 
maxchdevq = 2 
maxchdevs = 2 
maxconnections = 128 
maxlocks = 64 
maxopens = 250 
maxsearches = 50 
maxsessopens = 80 
maxsessreqs - 50 
maxsessvcs = 1 
maxs hares ■ 16 
netioalert = 5 
numbigbuf = 12 
numfiletasks = 1 
numreqbuf = 36 
sizreqbuf » 4096 
srvanndelta = 3000 
srvannounce = 60 

j The next lines help you to locate bits in the srvheuri sties entry. 
; 1 
5 01234567890123456789 

srvheuri sties - 11110141111311001331 
SRVSERVICES ° NETL0G0N , LSSERVER 
srvnets = NET1.NET2 

[alerter] 

sizalertbuf = 3072 

[netrun] 

maxruns = 3 
runpath *» C:\ 

[lsserver] 
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cleanup = yes 
srvpipes «* 3 

[servi ces] 

; Correlates name of service to pathname of service program. 

; The pathname must be either 

; 1) an absolute path (including the drive specification) 

; OR 

; 2) a path relative to the IBMLAN root 

alerter = services\alerter.exe 
dcdbrepl = services\dcdbrepl.exe 
dlrinst = services\dlrinst.exe 
genalert = services\genalert.exe 
; Correlates name of service to pathname of service program. 

; The pathname must be either 

; 1) an absolute path (including the drive specification) 

; OR 

; 2) a path relative to the IBMLAN root 

lsclient = services\lsclient.exe 
Isserver = services\lsserver.exe 
messenger = services\msrvinit.exe 
netlogon = services\netlogon.exe 
netpopup = services\netpopup.exe 
netrun = sdrvices\runservr.exe 
remoteboot = services\rplservr.exe 
replicator = services\replicat.exe 
requester = services\wksta.exe 
server = services\netsvini.exe 
timesource = services\timesrc.exe 
ups = services\ups.exe 



A.2 Configuration Files for Host MARTIN 

The following configuration was used for that system: 



Table 23. System Unit and Installed Software Products for Host MARTIN 


Hardware 


Software 


Functions 


IBM PS/2 80-111 


OS/2 2.1 


Telnet server/client 


16MB Memory 


TCP/IP V2.0 for OS/2 


FTP server/client 


Token-Ring Adapter/A 


IBM CM/2 


REXEC server/client 


Token-Ring Adapter/A 


AnyNet/2 


Rsh server/client 


Image Adapter/A 


OS/2 LAN Requester 


NFS server/client 


6091-19 Display 




Sendmail server/client 
LPR port client 
PMX server 
X Clients 
TCP/NetBIOS 
SLIP to MIERS 
SNALINK to MIERS 
LAN Requester 



CONFIG.SYS File 
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***** 



rem ***** OS/2 2.1 Entries, I 
IFS=C:\0S2\HPFS. IFS /CACHE: 1624 /CRECL:4 /AUTOCHECK: C 
PR0TSHELL=C:\0S2\PMSHELL . EXE 
rem ***** Image Adapter /A Entries, I ***** 

DEVICE=C:\0S2\IA0S2RFS.SYS 

rem ***** OS/2 2.1 Entries, II ***** 

SET USER_INI=C:\0S2\0S2. INI 

SET SYSTEMJNKs\0S2\0S2SYS.INI 

SET 0S2_SHELK.-\0S2\CMD.EXE 

SET AUTOSTART=PROGRAMS, TASKLIST, FOLDERS 

SET RUNW0RKPLACE=C :\0S2\PMSHELL. EXE 

SET C0MSPEC=C : \0S2\CMD . EXE 

set restartobjects=startupfoldersonly 

LIBPATH=C:\NETBI0S2;C:\IBMC0M\DLL;C:\IBMLAN\NETLIB;C:\MUGLIB\DLL;.; 

C : \0S2\DLL ;C : \CMLIB\DLL ; C:\0S2\MD0S ; C : \;C :\0S2\APPS\DLL ; 
c:\tool s;C:\TCPIP\DLL; 

SET PATH=C:\IBMLAN\NETPR0G;C:\0S2;C:\CMLIB;C:\MUGLIB;C:\0S2\SYSTEM; 

C : \0S2\MD0S\WI N0S2 5 C : \0S2\I NSTALL ; C : \ ; C : \0S2\MD0S ; C : \0S2\APPS ; 
c:\tools;C:\TCPIP\BIN; 

SET DPATH=C:\IBMC0M;C:\IBMLAN\NETPR0G 5 C:\IBHLAN;C:\0S2;C:\CMLIB; 

C:\MUGLIB\DLL;C:\0S2\SYSTEM;C:\0S2\MD0S\WIN0S2;C:\0S2\INSTALL; 

C : \ ; C : \0S2\B I TMAP ; C : \OS2\MDOS ; C : \0S2\APPS S c : \tool s ; 

SET PROMPT=$i [$p] 

SET HELP°C:\0S2\HELP;C:\0S2\HELP\TUT0RIAL;C:\CMLIB;C:\TCPIP\HELP; 
C:\TCPIP\BIN; 

SET GL0SSARY=C:\0S2\HELP\GL0SS; 

SET IPF_KEYS=SBCS 
PRIORITY_DISK_IO=YES 
autofail =yes 
pauseonerror=no 
FILES=50 

rem ***** LAPS Entries, I ***** 

DEVI CE=C : \I BMCOM\LANMSGDD . 0S2 /I:C:\IBMC0M 
DEVICE=C:\I BM COM\PROTMAN . 0S2 /I:C:\IBMCOM 
rem ***** OS/2 2.1 Entries, III ***** 

DEVICE=C:\0S2\TESTCFG. SYS 

DEVICE=C:\0S2\D0S.SYS 

D E V I C E=C :\0S2\PMDD.SYS 

BUFFERS=30 

IOPL=YES 

DISKCACHE=64,LW 

MAXWAIT=3 

MEMMAN=SWAP, PROTECT 

SWAPPATH=C : \0S2\SYSTEM 2048 2048 

BREAK=OFF 

THREADS=256 

PRINTMONBUFSIZE=134, 134,134 
COUNTRY=001 , C:\0S2\SYSTEM\C0UNTRY . SYS 
SET KEYS=ON 

REM SET DELDIR=C:\DELETE,512; 

BASEDEV=PRI NT02 . SYS 
BASEDEV=IBM2FLPY . ADD 
BASEDEV=IBM2ADSK.ADD 
BASEDEV=0S2DASD . DMD 

SET BOOKSHELF=C:\IBMLAN\BOOK;C:\OS2\BOOK 5 C:\CMLIB\BOOK;c:\tools;C:\TCPIP\DOC; 
SET EPMPATH=C:\0S2\APPS; c:\tools; 

DEVICES :\0S2\APPS\SASYNCDB. SYS 
PROTECTONLY=NO 

SHELL=C : \0S2\MD0S\C0MMAND . COM C:\0S2\MD0S 
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FCBS=16,8 

RMSIZE=640 

DEV I CE=C : \0S2\MD0S\VEMM .SYS 
DOS=LOW,NOUMB 

DEVICE=C :\0S2\MD0S\VDPX . SYS 
DEVICE=C:\0S2\MD0S\VXMS. SYS /UMB 
DEVICE=C:\0S2\MD0S\VDPMI .SYS 
DEV I CE=C : \0S2\MD0S\VCDR0M . SYS 
DEV I CE=C : \0S2\MD0S\VWI N .SYS 
DEVI CE=C : \OS2\MDOS\VMOUSE . SYS 
DEV I CE=C : \0S2\P0 INTDD.SYS 
DEVICE=C:\0S2\M0USE.SYS 
DEVI CE=C : \0S2\C0M. SYS 
DEV I CE=C : \OS2\MDOS\VCOM . SYS 
CODEPAG E=437 , 850 

DEVI NFO=KBD , US, C:\0S2\KEYB0ARD . DCP 

DEVINFO=SCR, VGA, C:\0S2\VI0TBL.DCP 

rem ***** i ma g e Adapter /A Entries, II ***** 

REM SET V I D EO_DEV I C ES= V I 0_85 14A 

REM SET VI0_8514A=DEVICE(BVHVGA,BVH8514A) 

DEVI CE=C : \0S2\MD0S\V VGA . SYS 
DEVI CE=C : \0S2\MD0S\V I AA . SYS 
SET VIDEO_DEVICES=VIO IAA 
SET VIO IAA=DEVICE(BVHVGA,BVHIAA) 
rem ***** LAPS Entries, II ***** 

RUN=C : \ I BMCOM\PROT OCOL\NETB I ND . EXE 

RUN=C : \IBMCOM\LANMSGEX. EXE 

DEVICE=C:\IBMC0M\MACS\IBMT0K.0S2 

DEVICE=C:\IBMC0M\MACS\IBMT0K.0S2 

DEVICE=C:\NETBI0S2\NBDRIVER.SYS -s 40 -c 95 -n 21 

REM * Replaced by Sockets over SNA * DEVICE«C:\IBMCOM\PROTOCOL\INET.SYS 

REM * Replaced by Sockets over SNA * DEVICE=C:\IBMCOM\PROTOCOL\IFNDIS.SYS 

REM ******* Sockets over SNA Environment Variables *******= 

DEVICE=C:\TCPIP\8IN\SNACKETS.SYS 

DEVICE=C:\TCPIP\BIN\IFNDIS.SYS 

SET ETC=C:\TCPIP\ETC 

REM ******* End of Sockets over SNA Environment Variables *******= 

DEVICE=C:\IBMC0M\PR0T0C0L\NETBEUI.0S2 

DEVICE=C:\IBMLAN\NETPROG\RDRHELP.200 

I FS=C : \IBMLAN\NETPROG\NETWKSTA. 200 /I:C:\IBMLAN /N 

rem DEVICE=C:\IBMC0M\PR0T0C0L\NETBI0S.0S2 

DEVICE=C:\IBMCOM\PROTOCOL\LANDD.OS2 

DEV I C E=C : \ I BMCOM\PROTOCOL\LANDLLDD . 0S2 

DEV I C E=C : \ I BMCOM\PROTOCOL\LANPDD . 0S2 

DEVICE=C:\IBMCOM\PROTOCOL\LANVDD.OS2 

RUN=C : \IBMCOM\PROTOCOL\LANDLL . EXE 

DEV ICE=C : \CMLIB\ACSLANDD . SYS 

DEV I CE=C : \CMLIB\CMKFMDE . SYS 

DEVICE=C:\0S2\L0G.SYS 

RUN=C:\0S2\SYSTEM\L0GDAEM. EXE 

RUN=C: \0S2\EPWR0UT.EXE 2 

RUN=C : \0S2\EPW . EXE 

RUN=C :\I BMLAN\NETPROG\LSDAEMON . EXE 

DEVI CE=C s \ I BMLAN\NET PR0G\V NETAPI . 0S2 

RUN=C:\IBMLAN\NETPROG\VNRMINIT.EXE 

set almcopy=/stat:ful1 /k: 32759 

rem ***** TCP/IP 2.0 Entries ***** 

REM * Replaced by Sockets over SNA * SET ETC=C:\TCPIP\ETC 
SET TMP=C:\TCPIP\TMP 
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SET READ I BM=C : \TCPI P\DOC 

SET HOSTNAME=marti n 

RUN=C:\TCPIP\BIN\CNTRL. EXE 

IFS°C:\TCPIP\BIN\NFS2G0. IFS 

DEV ICE=C : \TCPI P\BI N\VDOSTCP. VDD 

DEVICE=C:\TCPIP\BI N\VDOSTCP- SYS 

RUN=C : \TCPI P\BI N\VDOSCTL. EXE 

SET LIB=C:\TCPIP\LIB 

SET I NCLUDE=C : \TCPI P\ INCLUDE 

SET DISPLAY=martin:0 

SET XFI LES=C :\TCPI P\X1 1 

SET TZ=est5edt 

SET NFS. PERMISSION. BITS=777 

SET NFS. PERMISSION. DBITS=777 

SET LPR_SERVER=9 .67.38.69 

SET LPR_PRINTER=1 ptl 

SET USER=martin 

SET PASSWD=martin 

SET NEWSSERVER=hawnews . watson . i bm. com 

SET SYSCONTACT=Marti n MURHAMMER 

SET SYSLOCATION=DD 101 

SET XFI LESEARCHPATH=c :\tcpi p\Xll 

SET XAPPLRESDIR=c:\tcpip\Xll 

SET XENVIRONMENT=c:\tcpip\ETC\Xresource 

SET XKEYSYMDB=c:\tcpi p\XKeysymDB 

REM ******* IBM Library Reader/2 Environment Variables *******= 

SET BOOKMGR=C:\TCPIP\BIN; 

SET READIBM=T:\; 

REM ******* End of IBM Library Reader/2 Environment Variables *******= 
REM ******* APPC over TCP/IP Environment Variables *************= 

SET CONNWAIT_SECS=30 

SET CRITICAL_WS=NO 

SET MPTN_WELL_KNOWN_PORT =397 

SET SNASUFFIX=SNA. IBM.COM 

SET TCPWAIT_MINS=15 

SET UNACKED DG RETRY SECS=30 

SET UNSENT_DG_RETRY_SECS=3 

******************** *♦★**★**★★**★**★***★***★★*★*★★*★★★★2; 



STARTUP.CMD File 

@echo off 

call c:\tcpip\bin\setup.cmd 

START " NetBIOS/2 0 c:\netbios2\NBTCP -d 9.67.38.81 9.67.38.127 
exit 

PROTOCOL.INI File 
[PROT_MAN] 

DRIVERNAME = PROTMAN$ 

[IBMLXCFG] 

LANDD_nif = LANDD.NIF 
NETBEUI_ni f = NETBEUI. nif 
tcpip_nif = tcpip.nif 
IBMTOK_nif = IBMTOK.nif 
IBMT0K_nif2 = IBMTOK.nif 
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[LANDD_nif] 

DriverName = LANDD$ 
Bindings = IBMTOK_nif 
ETHERAND_TYPE » "I" 
SYSTEMJCEY = 0x0 
OPEN OPTIONS = 0x2000 
TRACE = 0X0 
LINKS = 8 
MAX SAPS = 3 
MAX'G SAPS = 0 
USERS~= 3 
TI_TICK_G1 = 255 
T1~TICK G1 = 15 
T2 TICK'Gl - 3 
TI~TICK G2 = 255 
T1 TICK~G2 = 25 
T2~TICK G2 = 10 
I PACKETS = 250 
UIPACKETS = 100 
MAXTRANSMITS = 6 
MINTRANSMITS = 2 
TCBS = 64 
GOTS = 30 
ELEMENTS = 800 

[NETBEUI_nif] 

DriverName = netbeui$ 
Bindings = IBMTOK nif 
ETHERANDJYPE = *1“ 
USEADDRREV = "YES* 
0S2TRACEMASK = 0x0 
SESSIONS = 40 
NCBS = 95 
NAMES = 21 
SELECTORS = 5 
USEMAXDATAGRAM = "NO" 
ADAPTRATE = 1000 
WINDOUERRORS = 0 
MAXDATARCV = 4168 
TI =• 30000 
T1 = 500 
T2 - 200 
MAXIN » 1 
MAXOUT = 1 

NETBIOSTIMEOUT = 500 
NETBIOSRETRIES = 8 
NAMECACHE = 0 
PIGGYBACKACKS = 1 
DATAGRAMPACKETS = 2 
PACKETS = 350 
LOOPPACKETS = 1 
PIPELINE = 5 
MAXTRANSMITS = 6 
MINTRANSMITS = 2 
DLCRETRIES = 5 

[tcpip_nif] 
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DriverName ■ TCPIP$ 

Bindings = IBMTOK_nif,IBMTOK_nif2 

[IBMTOK_ni f] 

DriverName = IBMTOK$ 

ADAPTER => “PRIMARY" 

NETADDRESS ° “400000032240" 

MAXTRANSMITS = 6 
RECVBUFS = 2 
RECVBUFSIZE = 256 
XMITBUFS = 2 

[IBMT0K_nif2] 

DriverName » IBMT0K2$ 

ADAPTER = “ALTERNATE* 

MAXTRANSMITS = 6 
RECVBUFS = 2 
RECVBUFSIZE = 256 
XMITBUFS = 2 

SETUP.CMD File 

route -fh 
arp -f 

ifconfig lan0 9.67.38.81 netmask 255.255.255.192 

REM ifconfig lanl 9.24.97.12 netmask 255.255.255.0 

REM ifconfig lan2 

REM ifconfig lan3 

REM Ifconfig lan4 

REM ifconfig 1an5 

REM ifconfig lan6 

REM ifconfig lan7 

REM ifconfig s10 

route add subnet 9.67.32.64 9.67.38.75 1 
route add subnet 9.67.38.0 9.67.38.90 1 
route add subnet 9.67.212.0 9.67.38.90 2 
route add subnet 9.67.38.128 9.67.38.65 1 

TCPSTART.CMD File 

@echo off 

echo CONFIGURING TCP/IP 

IF EXIST C:\TCPIP\BIN\B4TCP.CMD CALL C:\TCPIP\BIN\B4TCP.CMD 
IF EXIST C:\TCPIP\BIN\SETUP.CMD CALL C:\TCPIP\BIN\SETUP.CMD 
echo FINISHED CONFIGURING TCP/IP 



echo STARTING THE TCP/IP PROCESSES 

start /min inetd 

echo I NET Daemon Started 

REM start telnetd 

REM echo TELNET Daemon Started 

REM start ftpd 

REM echo FTP Daemon Started 

REM start tftpd 

REM echo TFTP Daemon Started 
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REM start REXECD 

REM echo REXEC Daemon Started 

REM start rshd 

REM echo RSH Daemon Started 

start /min Ipd 

echo IP Daemon Started 

start pmx -nocopyright 

echo X System Server Started 

start /min talkd 

echo TALK Daemon Started 

start /min portmap 

echo Portmapper Started 

start /min nfsd 

echo Network File System Server Started 

call nfsstart 

echo Network File System Client Started 

REM start routed 

REM echo ROUTED Started 

start /min sendmail -bd -q30m 

echo SENDMAIL Started 

REM start nr2 

REM echo NR2 Started 

start lamail 

echo LAMAIL Started 

detach Iprportd 

echo LPRPORTD Started 

echo FINISHED STARTING THE TCP/IP PROCESSES 

IF EXIST C:\TCPIP\BIN\TCPEXIT.CMD CALL C:\TCPIP\BIN\TCPEXIT.CMD 
echo EXITING TCPSTART.CMD 

RHOSTS File 

mi ers . i tsc . ral ei gh . i bm.com scott 
murphy.itsc.raleigh.ibm.com eamon 
marti n . i tsc . ral ei gh . i bm. com marti n 
osx25. i tsc. ral ei gh . i bm. com marti n 
os25 . i tsc . ral ei gh . i bm. com marti n 
dos20 . i tsc. ral ei gh . i bm. com marti n 
rs60007 . i tsc . ral ei gh. i bm.com marti n 

XOHOSTS File 

dec 

dos20 

martin 

mi ers 

murphy 

mvsl8sna 

os25 

osx25 

rs60007 

sun 

rs60001 

rs60002 

rs60003 

rs60004 

TRUSERS File 



380 TCP/IP V2.0 tor OS/2 




user: miers scott 
rd: c:\tcpip\tmp 
wr: c:\tcpip\tmp 

user: murphy eamon 
rd: c:\tcpip\tmp 
wr: c:\tcpip\tmp 

user: martin martin 
rd: c:\ 
wr: c:\ 

user: anonymous 
rd: c:\tcpip\tmp 
wr: c:\tcpip\tmp 

NETRC File 

machine martin login murli password martin 

machine rs60007 login martin password svo07m 

machine ralyas4b login martin password martin 

machine cidserver login martin password martin macdef rextest 

bell 

prompt 

status 



RESOLV File for Local Connectivity 

domain itsc.ra1eigh.ibm.com 
nameserver 9.67.38.115 

RESOLV File for Internet Connectivity 

domain itsc.ra1eigh.ibm.com 
nameserver 9.19.141.242 

FSTAB File 

mount r: rs60007:/u/martin 

mount t: cidserver:d:\book 

IBMLAN.INI File 

; OS/2 LAN Requester initialization file 
[networks] 

netl = NETBEUI}, 0,LM10, 32, 50, 14 
net2 = NETBIOS}, 0,NB30, 32, 50, 14 

; This information is read by the redirector at device initialization time, 
[requester] 

COMPUTERNAME » WTR32240 
DOMAIN - WTRNBTCP 

; The following parameters generally do not need to be 
; changed by the user, 
charcount = 16 
chartime «* 250 
charwait = 3600 
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keepconn = 689 
keepsearch = 689 
maxcmds = 16 
maxerrorlog = 189 
maxthreads - 19 
maxwrkcache = 64 
numalerts = 12 
numcharbuf = 18 
numservices = 7 
numworkbuf = 15 
numdgrambuf = 14 
othdomains = 
printbuftime = 99 
sesstimeout = 45 
sizcharbuf = 512 
sizerror = 1924 
sizworkbuf = 4896 

; The next lines help you to locate bits in the wrkheuri sties entry. 
; 12 3 

; 8123456789912345678991234567698123 

wrkheuri sti cs = 1111111121311111119891811128111221 
wrkservices = LSCLIENT, MESSENGER, NETPOPUP 
wrknets = NETl,net2 

[messenger] 

logfile = messages.log 
sizmessbuf = 4896 

[peer] 

auditing = no 

; The following parameters generally do not need to be 
; changed by the user. NOTE : srvnets= is represented in 
j the server info struct as a 16-bit lan mask. Srvnet names 
j are converted to indexes within [networks] for the named nets, 
guestacct = guest 
autodisconnect = -1 
maxauditlog = 188 
maxchdevjob = 2 
maxchdevs = 1 
maxconnecti ons = 26 
maxlocks = 64 
maxopens - 128 
maxsearches = 58 
maxsessopens = 128 
maxsessreqs = 25 
maxsessves = 1 
maxshares - 16 
maxusers = 5 
numbigbuf = 4 
numfiletasks = 1 
numreqbuf = 18 
sizreqbuf = 4096 

; The next lines help you to locate bits in the srvheuri sties entry. 
; 1 
; 8123456789012345678 

srvheuri sties = 1111014111131100133 
SRVSERVICES = 



382 TCP/IP V2.0 for OS/2 




security = Share 
srvnets = NETl,net2 

[Isclient] 

multi logon = yes 
timesync = yes 
logonverifi cation = domain 
logonwarningmsgs = all 

[replicator] 

replicate = IMPORT 

importpath = C:\ibmlan\repl\import 

tryuser = yes 

password = 

[services] 

5 Correlates name of service to pathname of service program. 

; The pathname must be either 

; 1 ) an absolute path (including the drive specification) 

; OR 

; 2) a path relative to the IBMLAN root 

Isclient = s'ervi ces\lsclient.exe 
messenger = services\msrvinit.exe 
netpopup = services\netpopup.exe 
peer = services\netpsini.exe 
replicator = services\rep 1 icat.exe 
requester = services\wksta.exe 



A.3 Configuration Files for Host MIERS 

The following configuration was used for that system: 



Table 24. System Unit and Installed Software Products for Host MIERS 


Hardware 


Software 


Functions 


IBM PS/2 80-111 
16MB Memory 
Token-Ring Adapter/A 
8514 Adapter/A 


OS/2 2.1 

TCP/IP V2.0 for OS/2 
IBM CM/2 
HCL eXceed/Win 
AnyNet/2 

OS/2 LAN Requester 
SPM/2 


Telnet client 
FTP client 
NFS client 

Sendmail server/client 
LaMail 

News Reader 
PMX server 
X Window client 
DOS/Windows Access 
SLIP to MARTIN 
SNALINK to MARTIN 



CONFIG.SYS File 

I FS=C : \0S2\HPFS . I FS /CACHE: 1024 /CRECL:4 /AUTOCHECK:C 

PR0TSHELL=C:\0S2\PMSHELL. EXE 

SET USER_INI=C:\0S2\0S2. INI 

SET SYSTEM_INI=C:\0S2\0S2SYS.INI 

SET 0S2_SHELL=C : \0S2\CMD . EXE 

SET AUTOSTART “PROGRAMS .TASKLIST, FOLDERS 

set restartobjects=startupfoldersonly 
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SET RUNW0RKPLACE-Cj\0S2\PMSHELL.EXE 
SET C0MSPEC=C : \0S2\CMD . EXE 

LIBPATH=C:\IBMC0M\DLL;C:\MUGLIB\DLL;.;D:\;C:\0S2\DLL;C:\CMLIB\DLL; 

C : \0S2\MD0S ;C : \; C :\0S2\APPS\DLL; C : \TOOLS ; C: \TCPIP\DLL; 

C : \SPM2V2 ; U : \EXC EEDW 

SET PATH=C:\0$2;C:\CMLIB;C:\MUGLIB;C:\0S2\SYSTEM;C:\0S2\MD0S\WIN0S2; 

C : \0S2\ I MST ALL ; C : \ ; C : \0S2\MD0S j C : \0S2\APPS j C : \T00 LS ; 
C:\TCPIP\BIN;C:\S PM2V2;U:\EXCEEDW 
SET OPATH=C : \ I BMCOM ; C : \0S2 ; C : \CM LI B ; C : \MUGL I B\DLL 5 C : \0S2\S YST EM ; 

C : \0S2\MD0S\W I N0S2 ; C : \0S2\ I NSTALL ; C : \ 5 C : \0S2\B I TM AP 5 C : \OS2\MDOS j 
C : \0S2\APPS ;C:\TOOLS; C:\SPM2V2; 

SET PROMPT=$i [$p] 

SET HELP=C:\0S2\HELPjC:\0S2\HELP\TUT0RIAL;C:\CMLIB;C:\TCPIP\HELP;K:\{ 
C:\SPM2V2; 

SET GLOSSARY=C : \0S2\HELP\GL0SS ; 

SET IPF_KEYS=SBCS 

PRIORITY_DISK_IO=YES 

FILES=20 

DEV I CE=C : \I BMCOM\PROT OCOL\LANPDD . 0S2 

DEV I CE=C : \I BMCOM\PROT OCOL\LAN VDD . 0S2 

DEV I CE=C : \I BMCOM\LANMSGDD . 0S2 /I:C:\IBMCOM 

DEV I CE=C : \I BMCOM\PROTMAN . 0S2 /I:C:\IBMCOM 

DEVI CE=C : \0S2\TESTCFG . SYS 

DEVICE=C:\052\D0S.SYS 

DEVICE=C:\0S2\PMDD.SYS 

BUFFERS=30 

IOPL=YES 

DISKCACHE=64,LW 

MAXWAIT=3 

MEMMAN=SWAP, PROTECT 

SWAPPATH=C : \0S2\SYST EM 2046 2048 

BREAK=OFF 

THREADS=256 

PRINTM0MBUFSIZE=134,134,134 
COUNTRY=001, C:\0S2\SYSTEM\C0UNTRY.SYS 
SET KEYS=ON 

REM SET DELDIR=C:\DELETE,512; 

BASEDEV=PRI NT02 . SYS 
BASEDEV=IBM2FLPY . ADD 
BASEDEV=IBM2ADSK.ADD 
BASEDEV-0S2DASD. DMD 

SET BOOKSHELF=C:\OS2\BOOK;C:\CMLIB\BOOK;C:\OS2\APPS;C:\TCPIP\DOC;Ks\} 
C:\SPM2V2; 

SET EPMPATH=C s \0S2\APPS ; 

DEVICE=C:\0S2\APPS\SASYNCDB.SYS 

PROTECTONLY=NO 

SHELL=C : \0S2\MD0S\C0MMAND . COM C:\0S2\MD0S 

FCBS=16,8 

RMSIZE=640 

DEV I CE=C : \OS2\MDOS\VEMM .SYS 
DOS=LOW,NOUMB 

DEVICE=C s \OS2\MDOS\VDPX . SYS 
DEVICE=C:\OS2\MDOS\VXMS.SYS /UMB 
DEV I CE=C : \OS2\MDOS\VDPM I . SYS 
DEVICE=C:\OS2\MDOS\VCDROM . SYS 
DEVICE=C:\0S2\MD0S\VWIN.SYS 
DEVICE=C:\OS2\MDOS\VMOUSE.SYS 
DEV I CE=C : \0S2\P0 I NTDD . SYS 
DEVICE=C:\0S2\M0USE.SYS 
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DEV I CE=C : \0S2\C0M .SYS 
DEVICE=C:\OS2\MDOS\VCOM . SYS 
CGDEPAGE=437 , 850 

DEV I NFO=KBD , US , C : \0S2\ KEYBOARD . DCP 

SET VIDEO_DEVICES=VIO 8514A 

DEV I CE=C : \0S2\MD0S\ V VGA . SYS 

RUN=C : \ I BMCOM\PROTOCOL\NETB I ND . EXE 

RUN=C:\IBMCOM\LANMSGEX. EXE 

DEVICE=C:\IBMC0M\MACS\IBHT0K.0S2 

RUN=C : \ I BHCOM\PROTOCOL\LANDLL . EXE 

DEVI CE=C : \CML I B\DFTDD .SYS 

DEVICE=C:\CMLIB\ACSLANDD.SYS 

DEVICE=C:\CMLIB\CMKFMDE.SYS 

DEV I CE=C : \0S2\L0G .SYS 

RUN=C : \0S2\SYSTEM\L0GDAEM . EXE 

RUN=C:\0S2\EPWR0UT. EXE 1 

RUN=C:\0S2\EPW.EXE 

rem set lotuspersonal=C:\123G 

DEVI CE=C : \I BMCOM\PROTOCOL\ I NET . SYS 

DEVICE=C:\IBMCOM\PROTOCOL\IFNDIS.SYS 

SET ETC=C:\TCPIP\ETC 

SET TMP=C:\TCPIP\TMP 

SET READIBH=C:\TCPIP\DOC 

SET HOSTNAME=mi ers 

RUN=C : \TCPI P\B I N\CNTRL . EXE 

IFS=C:\TCPIP\BIN\NFS20O. IFS 

DEVICE=C:\TCPIP\BIN\VDOSTCP.VDD 

DEV I CE=C : \TCPI P\B I N\VDOST CP . SYS 

RUN=C : \TCPI P\B I N\ VDOSCTL . EXE 

SET LIB=C:\TCPIP\LIB 

SET I NCLUDE=C : \TCPI P\ I NCLUDE 

SET DISPLAY=miers:0 

SET XFI LES=C : \TCPI P\X 11 

SET TZ=est5edt 

SET NFS. PERMISSION. BITS=700 

SET NFS. PERMISSION. DBITS=700 

SET TELNET. PASSWORD. ID-singsong 

SET NEWSSERVER=sernews . ral ei gh.1bm.com 

SET SPMSNAP=E C:\SPM2V2\SPMSNAP.ERR 

DEVI CE=C : \SPM2V2\THESEUS2 . SYS 

RUN=C : \SPM2 V2\SPMNBL . EXE /LISTEN 

DEVICE=C:\IBMCOM\PROTOCOL\NETBEUI . (JS2 

DEV I CE=C : \I BMCOM\PROTOCOL\NETB I OS . 0S2 

DEVI CE=C : \I BMCOM\PROT OCOL\LANDD . 0S2 

DEV I CE=C : \ I BMCOM\PROT OCOL\LANDLLDD . 0S2 

SET XFILESEARCHPATH°c:\tcpip\Xll 

SET XAPPLRESD I R=c : \tcpi p\Xl 1 

SET XENVIRONMENT=c:\tcpi p\ETC\Xresource 

SET XKEYSYMDB=c:\tcpi p\XKeysymDB 

SET VIO_VGA=DEVICE(BVHVGA) 

DEV I NFO=SCR, BGA , C : \0S2\V I OTBL . DCP 
SET VI0_8514A=DEVICE(BVHVGA,BVHB514A) 
DEVICE=C : \0S2\MD0S\V8514A. SYS 

STARTUP.CMD File 

cd\tcpip\bin 
rem call setup 
rem call nfsstart.cmd 
rem call \cmd\mountsm.cmd 
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PROTOCOL.INI File 

[PROT_MAN] 

ORIVERNAME = PR0TMAN$ 

[IBMLXCFG] 

LANDD_ni f = LANOD.NIF 
NETBEUI_ni f = NETBEUI. nif 
tcpip_nif = tcpip.nif 
IBMTOK_ni f = IBMTOK.nif 

[LANDO_nif] 

DriverName = LANDD$ 
Bindings = IBMTOK_nif 
ETHERAND_TYPE = "I" 
SYSTEM_KEY = 0x0 
OPEN_OPTIONS = 0x2000 
TRACE = 0x0 
LINKS = 8 
MAX SAPS = 3 
max”g_saps = 0 
USERS = 3 
TI TICK_G1 = 255 
TljlCK G1 = 15 
T2 TICKJl = 3 
TfTICK G2 = 255 
T1 _ TICK~G2 = 25 
T2 _ TICK G2 = 10 
I PACKETS = 250 
UI PACKETS = 100 
MAXTRANSMITS = 6 
MINTRANSMITS = 2 
TCBS = 64 
GDTS = 30 
ELEMENTS = 800 

[NETBEUI jiif] 

DriverName = netbeui$ 
Bindings = IBMTOK_nif 
ETHERANDJYPE = "I" 
USEADDRREV = "YES" 
0S2TRACEMASK = 0x0 
SESSIONS = 40 
NCBS = 95 
NAMES = 21 
SELECTORS = 5 
USEMAXDATAGRAM = "NO" 
ADAPTRATE = 1000 
WINDOWERRORS = 0 
MAXDATARCV = 4168 
TI = 30000 
Tl = 500 
T2 = 200 
MAXIN = 1 
MAXOUT = 1 
NETBIOSTIMEOUT = 500 
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NETBIOSRETRIES = 8 
NAMECACHE = 0 
PIGGYBACKACKS = 1 
DATAGRAMPACKETS = 2 
PACKETS = 350 
LOOPPACKETS = 1 
PIPELINE = 5 
MAXTRANSMITS = 6 
MINTRANSMITS - 2 
DLCRETRIES = 5 

[tcpipjiif] 



DriverName = TCPIP$ 

Bindings = IBMTOK_nif 

[IBMTOK_ni f] 

DriverName = IBMTOK$ 

ADAPTER = “PRIMARY" 

NETADDRESS = “400000032275“ 

MAXTRANSMITS = 6 
RECVBUFS = 2 
RECVBUFSIZE = 256 
XMITBUFS =■ 1 

SETUP.CMD File 

route -fh 
arp -f 

ifconfig lan0 9.67.38.106 netmask 255.255.255.192 

REM ifconfig lanl 

REM ifconfig lan2 

REM ifconfig lan3 

REM ifconfig lan4 

REM ifconfig 1an5 

REM ifconfig 1an6 

REM ifconfig lan7 

REM ifconfig si 0 

route add default 9.67.38.75 1 

TCPSTART.CMD File 

©echo off 

echo CONFIGURING TCP/IP 

IF EXIST C:\TCPIP\BIN\B4TCP.CMD CALL C:\TCPIP\BIN\B4TCP.CMD 
IF EXIST C:\TCPIP\BIN\SETUP.CMD CALL C:\TCPIP\BIN\SETUP.CMD 
echo FINISHED CONFIGURING TCP/IP 



echo STARTING THE TCP/IP PROCESSES 

start /min inetd 

echo I NET Daemon Started 

REM start telnetd 

REM echo TELNET Daemon Started 

REM start ftpd 

REM echo FTP Daemon Started 

REM start tftpd 

REM echo TFTP Daemon Started 
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REM start REXECD 

REM echo REXEC Daemon Started 

start pmx -nocopyright 

echo X System Server Started 

REM start talkd 

REM echo TALK Daemon Started 

start /min portmap 

echo Portmapper Started 

start nfsd 

echo Network File System Server Started 

REM call nfsstart 

REM echo Network File System Client Started 

REM start routed 

REM echo ROUTED Started 

REM start sendmail -bd -q30m 

REM echo SENDMAIL Started 

REM start nr2 

REM echo NR2 Started 

REM start lamail 

REM echo LAMAIL Started 

detach lprportd 

echo LPRPORTD Started 

echo FINISHED STARTING THE TCP/IP PROCESSES 

IF EXIST C:\TCPIP\BIN\TCPEXIT.CMD CALL C:\TCPIP\BIN\TCPEXIT.CMD 
echo EXITING TCPSTART.CMD 

RESOLV File 

domain itsc.raleigh.ibm.com 
nameserver 9.19.141.242 
nameserver 9.67.38.115 

AUTOEXEC.BAT File (MOOS) 

9ECH0 OFF 
ECHO. 

PROMPT $i$p$g 

REM SET DELDIR=C:\DELETE,512; 

PATH=C:\OS2;C:\OS2\MDOS;C:\OS2\MDOS\WINOS2;C:\;C:\TCPIP\DOS\BINj 

U:\EXCEEDW\IBM; 

LOADHIGH APPEND C:\0S2;C:\0S2\SYSTEM 
SET TMP=C:\ 

REM LOADHIGH DOSKEY FINDFILE=DIR /A /S /B $* 

REM DOSKEY ED I T=QB AS I C/ED I TO R $* 

REM SET DIRCMD=/A 

SET TEMP=C : \0S2\MD0S\WIN0S2\TEMP 

SET ETC=C:\TCPIP\DOS\ETC 

WIN. INI File (WIN-0S2) 

[wi ndows] 

device=IBM LaserPrinter 4019 PS17,pscript,LPT1.0S2 

load= 

run= 

Beep=yes 
Spool er=no 
NullPort=None 
BorderWidth=3 
CursorBl i nkRate=530 
Doubl eCl i ckSpeed=452 
Programs=com exe bat pi f 
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Documents 12 

Devi ceNotSel ectedT i meout=15 
Transmi ssl onRetryTimeout»45 
KeyboardDel ay-2 
KeyboardSpeed»31 
ScreenSaveActive-0 
ScreenSaveT i meOut-120 

[Desktop] 

Pattern-(None) 

Wallpaper-(None) 

Gri dGranul ari ty=0 
IconSpacing-100 

[Extensions] 
trm-tertni nal.exe A .trm 
rec-recorder.exe A .rec 
hlp-winhelp.exe A .hlp 
wri-write.exe A .wri 
pcx-pbrush.exe A .pcx 
bmp-pbrush.exe A .bmp 
cal-calendar.exe A .cal 
crd-cardfile.exe A .crd 
txt-notepad.exe A .txt 
ini-notepad.exe A . ini 

[inti] 

sLanguage-enu 

sCountry-United States 

i Country-1 

i Date-0 

i Time-0 

iTLZero-0 

1 Currency-0 

1CurrDigits=2 

i NegCurr-0 

1 Lzero-1 

IDigits-2 

i Measure-1 

S1159-AM 

S2359-PM 

sCurrency=$ 

sThousand-, 

sDecimal-. 

sDate-/ 

sTime-: 

slist-, 

s$hortDate=M/d/yy 
sLongDate-dddd, MMMM dd, yyyy 

[ports] 

; A line with [fi1ename].PRN followed by an equal sign causes 
; [filename] to appear in the Control Panel's Printer Configuration dialog 
; box. A printer connected to [filename] directs Its output into this file. 
LPT1:= 

LPT2:- 

LPT3:- 

COMl:=9600,n,8,l,x 

COH2:-9600,n,8,l,x 
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COM3:=9600,n,8,l,x 

COM4:=9600,n,8,l,x 

EPT:= 

FILE:= 

LPT1.0S2= 

LPT2.0S2= 

LPT3.0S2= 

[FontSubstitutes] 

He1v=MS Sans Serif 
Tms Rmn=MS Serif 
Times=Times New Roman 
Hel veti ca=Ari al 

[TrueType] 

[Sounds] 

SystemDefault=ding.wav, Default Beep 
SystemExcl amati on-chord . wav, Excl amati on 
SystemStart=tada . wav , Windows Start 
SystemExit=chimes.wav, Windows Exit 
SystemHand=chord.wav, Critical Stop 
SystemQuesti on=chord.wav, Question 
SystemAsteri sk=chord.wav, Asteri sk 

[mci extensions] 
wav=waveaudi o 
mid=sequencer 
rmi “sequencer 

[Compatibility] 

NOTSHELL=0x0001 

WPWINFI 1=0x0006 

CCMAIL=0x0008 

AMIPRO=0x0010 

REM=0x8022 

PIXIE=0X0040 

CP=0x0040 

JW=0x42080 

TME=0x0100 

VB=0x0200 

WIN2WRS=0xl210 

PACKRAT=0x0800 

VISION=0x0040 

MCOURIER=0x0800 

_BNOTES=0x24000 

M I LESV 3=0x1000 

PM4=0x2000 

DESI6NER=0x2000 

PLANNER=0x2000 

DRAW=0x2000 

WINSIM=0x2000 

CHARI SMA=0x2000 

PR2=0x2000 

PLUS=0xl000 

EO=0x00010000 

APORIA=0x0100 

EXCEL=0xl000 

6UIDE=0xl000 



390 



TCP/IP V2.0 tor OS /2 




NETSET2=0xO100 

W4GL=0x4O0O 

W4GLR=0x4000 

TURBOTAX°0x00080000 

[Microsoft Word 2.0] 

HPDSKJET=+1 

[fonts] 

Arial (TrueType) =ARIAL.F0T 

Arial Bold (TrueType)=ARIALBD. FOT 

Arial Bold Italic (TrueType)=ARIALBI.FOT 

Arial Italic (TrueType)=ARIALI.FOT 

Times New Roman (TrueType)=TIMES.FOT 

Times New Roman Bold (T rueType) =TIMESBD . FOT 

Times New Roman Bold Italic (TrueType)=TIMESBI.FOT 

Times New Roman Italic (TrueType)=TIMESI.FOT 

Wi ngDi ngs (TrueType) =WI NGD I NG . FOT 

Roman (Plotter)=ROMAN.FON 

Script (PI otter)=SCRIPT. FON 

Modern (Plotter)=MODERN.FON 

MS Sans Serif 8,10,12,14,18,24 (8514/a res)-sseriff.fon 
Courier 10,12,15 (8514/a res)=courf.fon 
MS Serif 8,10,12,14,18,24 (8514/a res)=seriff.fon 
Symbol 8,10,12,14,18,24 (8514/a res)=symbolf.fon 
Small Fonts (8514/a res)=smallf.fon 

[embedding] 

Package=Package , Package , packager. exe , pi ct ure 

SoundRec=Sound , Sound , SoundRec . exe, pi cture 

PBrush=Pai ntbrush Pi cture , Pai ntbrush Pi cture , pbrush . exe , pi cture 

[Pri nterPorts] 

IBM LaserPrinter 4019 PS17=pscript,LPT1.0S2, 45,15 
[devi ces] 

IBM LaserPrinter 4019 PS17=pscript,LPT1.0S2 
[col ors] 

Background-192 192 192 
AppWorkspace=255 255 255 
Window=255 255 255 
WindowText=0 0 0 
Menu=255 255 255 
MenuText=0 0 0 
ActiveTitle=0 0 128 
InactiveTitle=255 255 255 
TitleText=255 255 255 
ActiveBorder=192 192 192 
InactiveBorder=192 192 192 
Wi ndowFrame=0 0 0 
Scroll bar=192 192 192 
ButtonFace=192 192 192 
ButtonShadow=128 128 128 
ButtonText=0 0 0 
GrayText=192 192 192 
Hi 1 ight=0 0 128 
HilightText=255 255 255 
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InactiveTitleText=0 0 0 
ButtonHi1ight=255 255 255 

[Freemem] 

Position=l,l 

[Windows Help] 

H_WindowPosition=[213, 160, 213, 160,0] 
[spooler] 

wi ndow=0 0 636 408 
[PSCRIPT] 

External Printers=6 
Pri nter 1=40291760 
Pri nter2=40291730 
Pri nter 3=40293930 
Pri nter4=40293960 
Pri nter5=IBH17521 
Pri nter6=IBM39521 

[EXCEEDW] 

TRANSO I R=u s \exceedw\i bm 
HOMED I R=u s \exceedw 
USERD I R=u : \exceedw\user 
U$ERF0NTS=75dpi 
CUST0M=1 

[XENV] 

B I TMAPD I R=u : \exceedw\xdk\i nc 1 ude\x 1 l\bi tmaps 
XAPPLRESD I R=u : \exceedw\user 

SYSTEM. INI File (WIN-OS2) 

[boot] 

useos2shie1d=l 
os2shield=wi nshe1d.exe 
shell =progman.exe 
mouse . drv=mouse . drv 
network. drv= 
language. dll= 
comm. drv=comm. drv 
keyboard . drv=keyboard . drv 
system. drv=atmsys . drv 
j 386grabber=vga . 3gr 
; 286grabber=vgacol or . 2gr 
dri vers=mmsystem. dl 1 
MAVDMApps= 

WAVDMAPPS= 

atm. system. drv=system. drv 
di spl ay. drv=8514. drv 
sdi splay. drv=s8514. drv 
fonts . f on=8514sys . f on 
f i xedfon . fon=8514f i x. fon 
oemfonts . fon=8514oem. fon 
os2gdi .exe=GDI .EXE 
os2user . exe-user . exe 

[keyboard] 

subtype= 
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type=4 

keyboard .dll =kbdus .dll 
oemansi.bin= 

[boot. description] 

keyboard. typ=Enhanced 161 or 162 key US and Non US keyboards 

mouse. drv=Microsoft, or IBM PS/2 

network. drv=No Network Installed 

language. dll=English (American) 

system. drv=MS-D0S System 

codepage=437 

woafont.fon=English (437) 
aspect=188, 96,96 
display.drv=VGA 

[386Enh] 

mouse=*vmd 

network=*dosnet , * vnetbi os 

ebi os=*ebi os 

woaf ont-dosapp. fon 

display=*vddvga 

E6A80WOA. F0N=EGA86W0A. FON 

EGA46W0A. F0N=EGA46W0A. FON 

CGA86U0A. F0N-CGA86U0A. FON 

CGA46W0A. F0N=CGA48W0A. FON 

keyboard°*vkd 

devi ce=vtdapi. 386 

device=*vpicd 

device-* vtd 

devi ce=*reboot 

device=*vdmad 

devi ce=*vsd 

device=*v86mngr 

devi ce=*pageswap 

device=*dosmgr 

devi ce=* vmpol 1 

device=*wshell 

device=*BLOCKDEV 

device=*PAGEFILE 

device=*vfd 

device=*parity 

device=*biosxlat 

device=*vcd 

devi ce=*vmcpd 

device=*combuff 

device=*cdpscsi 

local “CON 

F11eSysChange=off 

Pagi ngFI 1 e=D :\WI N386 . SWP 

MaxPagi ngFI 1 eSi ze-26486 

[standard] 

[NonWi ndowsApp] 
local tsrs=dosedi t,ced 

[mci] 

Wave Audi o=mci wave . drv 
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Sequencer=mci seq . drv 
CDAudi o=mci cda . drv 

[dri vers] 

time r=timer. drv 

mi dimapper=mi dimap. drv 



A.4 Configuration Files for Host OS25 

The following configuration was used for that system: 



Table 25. System Unit and Installed Software Products for Host OS25 


Hardware 


Software 


Functions 


IBM PS/2 80-071 
10MB Memory 
Token-Ring Adapter/A 
IBM Ethernet Adapter/A 


OS/2 2.1 

TCP/IP V2.0 for OS/2 
OS/2 LAN Requester 


LPD server 
Telnet client 
FTP client 
NFS client 
TCP/NetBIOS 
CIO installed 
BOOTP client 
ROUTED IP router 
LAN Requester 



CONFIG.SYS File 

I FS=C : \0S2\HPFS . I FS /CACHE: 1024 /CRECl:4 /AUTOCHECK:C 

PR0TSHELL=C:\0S2\PMSHELL.EXE 

SET USER_INI=C:\0S2\0S2.INI 

SET SYSTEM INI=C:\0S2\0S2SYS. INI 

SET 0S2 SHELL=C : \0S2\CMD . EXE 

SET AUTOSTART=PROGRAMS, TASKLIST , FOLDERS, CONNECTIONS 

SET RUNWORKPLACE=C: \0S2\PMSHELL.EXE 

SET C0MSPEC=C : \0S2\CMD . EXE 

set restartobjects=startupfoldersonly 

LIBPATH°C:\NETBI0S2jC:\IBMC0M\DLL;C:\IBMLAN\NETLIB;. ;C:\0S2\DLL; 

C:\MUGLIB\DLL;C:\0S2\MD0S;C:\;C:\0S2\APPS\DLL;C:\TCPIP\DLL} 
SET PATH=C : \ I BMLAN\MET PROG ; C : \MUGLIB ; C : \0S2 ; C ; \0S2\SYSTEM; 

C : \0S2\MD0S\W I N0S2 ; C : \0S2\ I NSTALL 5 C : \ ; C : \0S2\MD0S ; 

C : \0S2\APPS ; C : \srvi f srq ; C : \TCPI P\BI N ; 

SET DPATH=C:\IBMC0M;C:\IBMLAN\NETPR0G;C:\IBMLAN;C:\MUGLIB;C:\0S2; 
C:\0S2\SYSTEM ; C : \0S2\MD0S\WI N0S2; C:\0S2\I NSTALL ;C : \ } 

C : \0S2\B I TMAP ; C : \0S2\MD0S ; C : \0S2\APPS ; 

SET PR0MPT=$p$g 

SET HELP=C:\0S2\HELP;C:\0S2\HELP\TUT0RIAL;C:\TCPIP\HELP;C:\TCPIP\BIN; 
SET GLOSSARY=C :\0S2\HELP\GL0SS ; 

SET IPF_KEYS=SBCS 
PRIORITY_DISK I0=YES 
FILES=20 
autofail=yes 
pauseonerror=no 

DEVICE=C:\IBMC0M\LANMSGDD.0S2 /I:C:\IBMC 0 M 

DEVICE=C:\IBMC0M\PR0TMAN.0S2 /I:C:\IBMC0M 

DEVICE = C : \0S2\TESTCFG . SYS 

DEVICE=C:\0S2\D0S.SYS 

DEVICE=C:\0S2\PMDD.SYS 

BUFFERS=30 

I0PL=YES 

rem DISKCACHE=64,LW 
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MAXWAIT°3 

MEMMAN=SWAP, PROTECT 
SWAPPATH=C:\ 2048 2048 
BREAK=OFF 
THREADS=256 

PRINTM0NBUFSIZE=134,134,134 
COUNTRY=001,C:\OS2\SYSTEM\COUNTRY.SYS 
SET KEYS=ON 

REM SET DELDIR=C:\0ELETE,512; 

BASEDEV=PRINT02.SYS 
BASEDEV=I BM2FLPY . ADD 
BASED EV=IBM2ADSK. ADD 
BASEDEV=0S2DAS0. DMD 
SET EPMPATH=C : \0S2\APPS ; 

DEV I CE=C : \0S2\P0 INTDD.SYS 
DEVICE=C:\0S2\M0USE. SYS 
DEVICE=C:\0S2\C0M.SYS 
C0DEPAGE=437 , 850 

DEV I NFO=KBD , US , C : \0S2\KEYB0ARD . DCP 
DEV I NFO=SCR , VGA , C : \0S2\V I OTBL . DCP 
SET VIDEO_DEVICES=VIO_VGA 
SET V I 0_VGA=DEV ICE (B VHVGA) 

RUN=C : \ I BMCOM\PROT 0C0L\NETB I ND . EXE 

RUN=C : \ I BMCOM\LANMSGEX . EXE 

DEVICE=Cs\I BMC0M\M ACS\ IBMT0K.0S2 

DEVICE=C:\I BMCOM\M ACS\M AC ETH . OS 2 

DEVICE=C:\NETBI0S2\NBDRIVER.SYS -s 40 -c 95 -n 21 

DEV 1 C E=C : \ I BMCOM\PROT 0C0L\I NET . SYS 

DEVICE=C:\IBMCOM\PROTOCOL\IFNDIS.SYS 

rem DEVICE=C:\IBMCOM\PROTOCOL\NETBEUI .0S2 

DEV I CE=C : \ I BMLAN\NET PROG\RDRHELP . 200 

IFS=C:\IBMLAN\NETPROG\NETWKSTA.200 /Is C:\IBMLAN /N 

rem DEVICE=C:\IBMC0M\PR0T0C0L\NETBI0S.0S2 

RUN=C:\I BMLAN\NETPROG\LSDAEMON . EXE 

DEVICE=C:\IBMLAN\NETPR0G\VNETAPI.0S2 

RUN=C:\IBM LAN\NETPROG\VNRMINIT.EXE 

SET ETC=C:\TCPIP\ETC 

SET TMP=C:\TCPIP\TMP 

SET BOOKSHELF=C:\TCPIP\DOC 

SET READIBM=C:\TCPIP\DOC 

SET H0STNAME=os25 

RUN=C:\TCPIP\BIN\CNTRL.EXE 

IFS=C:\TCPIP\BIN\NFS200.IFS 

SET TZ=est5edt 

SET NFS. PERMISSION. BITS=700 

SET NFS. PERMISSION. DBITS=700 

SET USER=os25 

SET NEWSSERVER=hawnews. watson .ibm. com 

STARTUP.CMD File 

call c:\tcpip\bin\tcpstart.cmd 

start •NetBI0S/2 B c:\netbios2\nbtcp 9.67.38.69 9.67.38.127 

NET START REQ 

EXIT 

PROTOCOUNI File 
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[PROT_KAN] 



ORIVERNAME = PROTMAN$ 

[IBMLXCFG] 

tcpip_nif = tcpip.nif 
IBMTOK_nif * ibmtok.nif 
maceth_nif = maceth.nlf 

[tcpip_nif] 

DriverName = TCPIP$ 

Bindings = IBMTOK_nif,maceth_nif 

[IBMT0K_ni f] 

DriverName = IBMT0K$ 

ADAPTER = "PRIMARY* 

NETADDRESS = "400030010692" 

MAXTRANSMITS = 6 
RECVBUFS *> 2 
RECVBUFSIZE = 256 
XMITBUFS = 1 

[macethjii f] 

DriverName = MACETH$ 

MaxRequests = B 
MaxTransmits = 12 
ReceiveBuffers = 12 
ReceiveBufSize = 256 
ReceiveChains = 12 

SETUP.CMD File 

route -fh 
arp -f 

ifconfig lanO 9.67.38.69 netmask 255.255.255.192 

ifconfig lanl 9.67.32.68 netmask 255.255.255.192 

REM ifconfig lan2 

REM ifconfig lan3 

REM ifconfig lan4 

REM ifconfig lan5 

REM Ifconfig 1an6 

REM ifconfig lan7 

REM ifconfig si 6 

route add subnet 9.67.38.6 9.67.38.96 1 
route add subnet 9.67.32.0 9.67.38.81 1 
route add subnet 9.67.212.0 9.67.38.99 2 
route add default 9.67.38.65 1 

TCPSTART.CMD File 

Oecho off 

echo CONFIGURING TCP/IP 

CALL C:\TCPIP\BIN\SETUP.CMD 

echo FINISHED CONFIGURING TCP/IP 
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echo STARTING THE TCP/IP PROCESSES 

REM start Inetd 

REM echo I NET Daemon Started 

REM start tftpd 

REM echo TFTP Daemon Started 

start /min Tpd -b -c 

echo LP Daemon Started 

REM start pmx -nocopyright 

REM echo X System Server Started 

REM start talkd 

REM echo TALK Daemon Started 

REM start portmap 

REM echo Portmapper Started 

REM start nfsd 

REM echo Network File System Server Started 

call nfsstart 

echo Network File System Client Started 

start routed 

echo ROUTED Started 

REM start sendmall -bd -q30m 

REM echo SENDMAIL Started 

REM start nr2 

REM echo NR2 Started 

REM detach Iprportd 

REM echo LPRPORTD Started 

echo FINISHED STARTING THE TCP/IP PROCESSES 

IF EXIST C:\TCPIP\BIN\TCPEXIT.CMD CALL TCPEXIT.CMD 
echo EXITING TCPSTART.CMD 

RESOLV File 

domain itsc.ralelgh.ibm.com 
nameserver 9.67.38.115 

IBMLANJNI 

; OS/2 LAN Requester initialization file 
[networks] 

; netl = NETBEUI$,6,LM16, 32,50, 14 
netl - NETBIOSS, O,NB30, 32, 56, 14 

; This information Is read by the redirector at device Initialization time, 
[requester] 

; The following parameters generally do not need to be 
; changed by the user, 
charcount * 16 
chartime » 250 
charwait » 3600 
keepconn *■ 600 
keepsearch - 606 
maxcmds » 16 
maxerrorlog ■ 100 
maxthreads » 10 
maxwrkcache - 64 
numalerts - 12 
numcharbuf ■ 10 
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numservices «* 7 
numworkbuf = 15 
numdgrambuf = 14 
othdomains = 
printbuftime = 90 
sesstimeout = 45 
sizcharbuf = 512 
sizerror = 1024 
sizworkbuf = 4096 

; The next lines help you to locate bits in the wrkheuri sties entry. 

; 12 3 

; 0123456789012345678901234567890123 

wrkheuri sti cs = 1111111121311111110001011120111221 
wrkservices = LSCLIENT,MESSENGER,NETPOPUP 
wrknets = NET1 
Computername = WTR10002 
Domain =■ WTRNBTCP 

[messenger] 

logfile = messages.log 
sizmessbuf = 4096 

[Isclient] 

multi logon = yes 
timesync « yes 
logonverifi cation = domain 
logonwarningmsgs = all 

[replicator] 

replicate = IMPORT 

importpath = C:\ibmlan\repl\import 

tryuser = yes 

password - 

[services] 

I Correlates name of service to pathname of service program. 

5 The pathname must be either 

; 1) an absolute path (including the drive specification) 

; OR 

; 2) a path relative to the IBMLAN root 

Isclient = services\lsclient.exe 
messenger = services\msrvinit.exe 
netpopup = services\netpopup.exe 
replicator = services\replicat.exe 
requester = services\wksta.exe 



A.5 Configuration Files for Host DOS20 

The following configuration was used for that system: 



398 TCP/IP V2.0 tor OS/2 





Table 26. System Unit and Installed Software Products for Host DOS20 


Hardware 


Software 


Functions 


IBM PS/2 70-F61 
10MB Memory 
Token-Ring Adapter/A 


DOS 5.0 

TCP/IP V2.1 for DOS 
DOS LAN Requester 
Windows 3.1 


Telnet client 
FTP client/server 
NFS client 
BOOTP client 
TCP/NetBIOS 
LAN Requester 



CONFIG.SYS File 

shell=c:\dos\command.com /e:2000 /p 
f11es= 50 

DEVICE=C:\DOS\SETVER. EXE 

DEVICE=C:\WINDOWS\HIMEM.SYS 

DOS=HIGH 

COUNTRY=001 , , C : \DOS\COUNTRY . SYS 

rem DEVICE=C:\DOS\DISPLAY.SYS C0N=(EGA,,1) 

DEVICE=C:\WINDOWS\SMARTDRV. EXE /DOUBLE BUFFER 

DEVICE = C:\TCPDOS\BIN\PROTMAN.DOS /I: C:\TCPDOS\ETC 

REM Consider removing drivers below this comment 

DEVICE = C:\TCPDOS\BIN\DOSTCP.SYS 

DEVICE = C:\TCPDOS\BIN\IBMTOK.DOS 

REM Consider removing drivers above this comment 

REM You may need to add 'DEVICE=' for this driver: IBMTOK.DOS 

rem DEV I CE=\LSP3 1\DXMAGM0D . SYS 

rem DEVICE=\LSP31\DXME0MOD.SYS 

STACKS=9,256 

device=c:\dos\ansi .sys 

lastdri ve=z 

AUTOEXEC.BAT File 

?echo off 

c:\tcpdos\bin\NETBIND 

C:\WINDOWS\SMARTDRV.EXE 

SET ETC=C : \TCPD0S\ ETC 

SET C0MSPEC°C:\D0S\C0MMAND. COM 

SET TCPBASE=C:\TCPDOS 

0ECHO OFF 

PROMPT $P$G 

PATH C:\DOSLANiC :\WINDOWS;C:\DOS;C:\TCPDOS\BIN;C:\UTIL;C:\CMD; 
SET TEMP=C:\D0S 
rem NLSFUNC 

rem MODE CON CODEPAGE PREPARE=((437) C:\DOS\EGA.CPI) 

rem MODE CON CODEPAGE SELECT=437 

KEYB US,, C:\D0S\KEYB0ARD. SYS 

doskey /reinstall 

rem MODE C0M1 96, N, 8,1 

REM ** SG ** MODE CON CODEPAGE PREPARE=((850) C:\DOS\EGA.CPI) 

REM ** SG ** MODE CON CODEPAGE SELECT=850 

REM KEYB GR,, C:\D0S\KEYB0ARD. SYS 

REM WIN 

CALL TCPSTART 

©ECHO OFF 

YNPROMPT Y N 30 Start DOS LAN Requester (Y/N)? 

IF ERRORLEVEL 1 GOTO NODLR 
NET START 

IF ERRORLEVEL 1 GOTO NODLR 
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CALL INITFSI.BAT 
:NODLR 

PROTOCOUNI File 

[PROTMAN_MOD] 

OriverName - PROTMAN$ 

5 

; IBM TCP/IP V2.1 for DOS 
• 

[TCPIP_V21] 

OriverName ■ DOSNDIS$ 

) 

• Bindings Statement 

I 

Bindings = IBMTOK,,, 

. ........... Adaptor Definitions 

[IBMTOK] 

; IBM Token Ring 
; IBMTOK. DOS 

DriverName - IBMT0K$ 

TCPSTART.BAT File 



=- TCPSTART batch file — ; 

=- begins by determining that the necessary environment variables are set 



@echo off 

IF %ETC%.=. GOTO ETCHELP 
INETCHK 

IF ERRORLEVEL 1 GOTO INET DOWN 
GOTO INETJJP 
: INET DOWN 



=- install the Protocol Stack 



IF %INET%.=. inet 

IF NOT %INET%.“. Inet -d %INET% 

if errorlevel 1 GOTO done 



Assign our IP address and set NETMASK and default ROUTE 



route -f 
arp -da 
REM slipdial 

ifconfig nd0 9.67.38.68 netmask 255.255.255.192 broadcast 9.67.38.127 up 
route add -hopcount 1 -mtu 1496 default 9.67.38.65 
PING -cl 9.67.38.65>nu1 
REM ftpd -b 

REM if errorlevel 8 echo FTP Daemon Started 

REM lpd -b -c 

REM if errorlevel 8 echo LP Daemon Started 

nbtcp 

if errorlevel 8 echo netBIOS Started 

REM routed 

REM if errorlevel 8 echo ROUTED Started 

echo. 

echo TCP/IP is enabled. 
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REM USER CUSTOMIZATION SECTION 
REM 

REM WARNING: Do not remove the lines, 'REM Begin_User_Customization' 
REM and 'REM End_User_Customi zati on ' because these are used 

REM to protect any user-added commands from being deleted by 

REM the CUSTOM program 

REM 

REM Begin_User_Customization 
REM End_User_Custom1zation 
goto DONE 



I NET UP 




ECHO TCP/IP is already up! 




goto DONE 




=- Provide any needed HELP 





sETCHELP 

ECHO You MUST set the«-[l;33;40m ETC<-[0;37;4Om variable 
ECHO before attempting to start TCPPLUS* 

: DONE 

TRUSERS File 

user: martin martin 
rd: c:\ 
wr: c:\ 



RESOLV File 

domain itsc.ra1eigh.ilnn.com 
nameserver 9.67.38.115 

DOSLAN.INI File 

RDR WTRNBDOS WTRNBTCP 

/SRV:8 /ASG:29 /NBC:4 /NBS:1K /BBC:1 /BBS:4K /PBC:4 /PBS: 128 
/PFS:32 /PFT:9S0 /PWT:250 /KUC:600 /KST:680 

/WRK: 111121101021210 



A.6 Configuration Files for Host ROUTX25 

The following configuration was used for that system: 



Table 27. System Unit and Installed Software Products for Host R0UTX2S 


Hardware 


Software 


Functions 


IBM PS/2 80-071 
10MB Memory 
Token-Ring Adapter/A 
X.25 Co-Processor/A 


OS/2 2.1 

TCP/IP V2.0 for OS/2 
IBM CM/2 


IP Router to RTP 
Telnet Client 
FTP client 



CONFIG.SYS File 
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I FS=C s \0S2\HPFS . I FS /CACHE: 1024 /CRECL:4 /AUTOCHECK:C 

PROTSHELL=C :\0S2\PMSHELL . EXE 

SET USER_INKj\0S2\0S2.INI 

SET S YSTEM_I N I=C : \0S2\0S2S YS .INI 

SET 0S2_SHELL=C : \0S2\CMD . EXE 

SET AUTOSTART=PROGRAMS , TASKLIST , FOLDERS 

set restartobjects=startupfolderson 1 y 

SET RUNW0RKPLACE=C:\0S2\PMSHELL. EXE 

SET COMSPEC=C :\0S2\CHD . EXE 

LI BPATH=C : \IBMCOM\DLL ; . ; C : \ USERDLLS ; C:\0S2\DLL ; C : \MUGLIB\DLL ; 

C:\CMLIB\DLLjC: \0S2\MD0S ; C : \ 5 C : \0S2\APPS\DLL ; C : \TCP I P\DLL ; 

SET PATH=C : \CMDS ; C : \0S2UT I LS ; C : \0S2 ; C : \CMLI B ;C : \MUGLIB; C:\0S2\SYSTEM; 

C : \0S2\MD0S\W I N0S2 ; C : \OS2\ I NST ALL ; C : \ j C : \0S2\MD0S j 
C:\0S2\APPS; C:\TCPIP\BIN; 

SET DPATH=C : \IBMCOM ; D : \0S2UT I LS ; C : \0S2 ; C : \SRV I FSRQ ; C : \CMLIB ; 

C:\MUGLIB\DLL;C:\0S2\SYSTEM;C:\0S2\MD0S\WIN0S2;C:\0S2\INSTALL; 
C:\;C:\0S2\BITMAP; C:\0S2\MD0S; C:\0S2\APPSj 
SET PROMPT=$e [7mOS2$e [ 0 m $P$G 

SET HELP=C:\0S2\HELP;C:\HELPLIB;C:\0S2\HELP\TUT0RIAL;C:\CMLIB}C:\TCPIP\HELP 
SET GLOSSARY=C : \0S2\HELP\GL0SS ; 

SET IPF_KEYS=SBCS 
PRIORITY_DISK_IO=YES 
FILES=20 
pauseonerror=no 
autofail =yes 

DEVI CE=C : \ I BMCOM\PROT OCOL\LANPDD . 0S2 

DEVI CE=C : \ I BMCOM\PROT OCOL\LANVDD . 0S2 

DEVICE=C : \IBMCOM\LANMSGDD . 0S2 /I : C:\IBMCCM 

DEV I CE=C : \ I BMCOM\PROTMAN . 0S2 /I:C:\IBMCOM 

DEVICE=C:\0S2\TESTCFG.SYS 

DEVICE=C:\0S2\D0S.SYS 

DEVICE=C:\0S2\PMDD.SYS 

BUFFERS=30 

IOPL=YES 

DISKCACHE=64,LW 

MAXWAIT=3 

MEMMAN=SWAP, PROTECT 
SWAPPATH=C:\ 2048 2048 
BREAK=OFF 
THREADS=256 

PRINTM0NBUFSIZE=134,134,134 
COUNTRY=001 , C:\0S2\SYSTEM\C0UNTRY . SYS 
SET KEYS=ON 

REM SET DELDIR=C:\DELETE,512; 

BASEDEV=PRI NT02 . SYS 
BASEDEV=IBM2FLPY . ADD 
BASEDEV= I BM2ADSK . ADD 
BASEDEV=0S2DASD . DMD 
SET EPMPATH=C : \0S2\APPS ; 

DEVICE=C:\0S2\P0INTDD.SYS 
DEVICES :\0S2\M0USE. SYS 
DEVICE=C : \0S2\C0M. SYS 
CODEPAGE=437,850 

DEVI NFO=KBD , US , C : \0S2\KEYB0ARD . DCP 
DEVINFO=SCR, VGA, C:\0S2\VI0TBL.DCP 
SET VIDEO_DEVICES=VIO_VGA 
SET VIO_VGA=DEVICE(BVHVGA) 

RUN=C:\I BMCOM\PROT OCOL\NETB I ND . EXE 
RUN=C : \ I BMCOM\LANMSGEX. EXE 
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DEVICE“C:\IBMC0M\MACS\IBMT0K.0S2 
DEV I CE=C : \CML I B\ACSLANDD . SYS 
DEVICE°C:\CMLIB\CMKFMDE.SY$ 

SET BOOKSHELF=C : \I NFLIB 5 C : \TCPI P\DOC ; 

SET ETC=C:\TCPIP\ETC 

SET TMP=C:\TCPIP\TMP 

SET REAOIBM=C:\TCPIP\DCC 

SET H0STNAME«routx25 

RUN°C ; \TCPI P\BIN\CNTRL . EXE 

I FS°C : \TCPI P\BI N\NFS280 . IPS 

DEV I C E=C : \ I BMCOM\PROT OCOL\ I NET . S YS 

DEV I CE=C : \I BMCOM\PROT OCOL\ I FND I S . SYS 

DEV I CE s C : \I BMCOM\PROT OCOL\NETBEUI . 0S2 

DEV ICE=C : \ I BMCOM\PROT OCOL\NETB IOS . OS2 

DEV I C E=C : \I BMCOM\PROT OCOL\LANDD . 0S2 

DEV ICE=C : \ I BHCOM\PROT OCOL\LANDLLDD . OS2 

RUN=C : \ I BMCOM\PROT OCOL\LANDLL . EXE 

DEVICE°C:\CMLIB\ICARICIO.SYS 
SET TZ=est5edt 
SET NFS. PERMISSION . BITS=700 
SET NFS. PERMISSION. DBITS=700 
SET IPX25.SVC=0 

STARTUP.CMD File 

start c:\cmllb\cmstart.exe x25cml 
cmwait -s e 

call c : \tcpi p\bi n\x25 . cmd 
call c:\tcpip\bin\setup.cmd 
exit 

PROTOCOL.INI File 
[PROT_MAN] 

DRIVERNAME = PROTMAN$ 

[IBMLXCFG] 

LANDD_nif = LANDD.NIF 
NETBEUI nif = NETBEUI. NIF 
TCPIP nTf = TCPIP.NIF 
IBMTOK_ni f = IBMTOK.nif 

[LANDD_nif] 

DriverName » LANDD$ 

Bindings = IBMTOK nif 
ETHERAND_TYPE « 'I* 

SYSTEM KEY ° 0x0 
OPEN_OPTIONS » 0x2000 
TRACE = 0x0 
LINKS * 8 
MAX_SAPS = 3 
MAX 6 SAPS = 0 
USERS~= 3 
TI TICK G1 = 255 
T1JICKJ1 - 15 
T2 TICK_G1 = 3 
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TI TICK G2 = 255 
Tl~ TICKG2 • 25 
T2~TICK~G2 = 10 
I PACKETS » 250 
UIPACKETS = 100 
MAXTRANSMITS = 6 
MINTRANSMITS - 2 
TCBS = 64 
GDTS » 30 
ELEMENTS = 860 

[NETBEUI_ni f] 

DriverName - netbeu1$ 
Bindings - IBMTOK nif 
ETHERAND TYPE - "I* 
USEADDRREV - -YES' 
OS2TRACEMASK - 0x0 
SESSIONS - 40 
NCBS » 95 
NAMES » 21 
SELECTORS - 5 
USEMAXDATAGRAM - “NO* 
ADAPTRATE ° 1000 
WINDOWERRORS - 0 
MAXDATARCV - 4168 
TI ■ 36060 
Tl = 500 
T2 » 206 
MAXIN - 1 
MAXOUT - 1 
NETBIOSTIMEOUT * 560 
NETBIOSRETRIES = 8 
NAMECACHE « 0 
PIGGYBACKACKS - 1 
DATAGRAMPACKETS - 2 
PACKETS - 350 
LOOPPACKETS » 1 
PIPELINE - 5 
MAXTRANSMITS - 6 
MINTRANSMITS = 2 
DLCRETRIES - 5 

[TCPIP_n1f] 

DriverName » TCPIP$ 
Bindings = IBMTOK_nif 

[IBMTOKjiif] 

DriverName = IBMTOK$ 
ADAPTER - -PRIMARY- 
NETADDRESS - -400000032241- 
MAXTRANSMITS - 6 
RECVBUFS - 2 
RECVBUFSIZE - 256 
XMITBUFS - 2 

SETUP.CMD File 
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route -fh 
arp -f 

ifconfig lanO 9.67.38.96 netmask 255.255.255.192 

REM ifconfig lanl 

REM ifconfig 1an2 

REM ifconfig 1an3 

REM ifconfig lan4 

REM ifconfig 1an5 

REM ifconfig 1an6 

REM ifconfig lan7 

REM ifconfig si 6 

route add default 9.67.38.75 1 

route add subnet 9.67.212.6 9.67.38.2 1 

X2S.CMD File 

start x25io.exe 
xiowait 

ifconfig x25 9.67.38.1 netmask 255.255.255.192 mtu 576 

X2SIP File 
L0CAL1 



X2SRTE File 
R0UTE1 



X2SDIR File 

default REM0TE1 



TCPSTART.CMD File 

@echo off 

echo CONFIGURING TCP/IP 

IF EXIST C:\TCPIP\BIN\B4TCP.CMD CALL C:\TCPIP\BIN\B4TCP.CMD 
IF EXIST Cs\TCPIP\BIN\SETUP.CMD CALL C:\TCPIP\BIN\SETUP.CMD 

echo FINISHED CONFIGURING TCP/IP 

REM 



echo STARTING THE TCP/IP PROCESSES 
REM start /min inetd 



REM echo I NET Daemon Started 

REM start tftpd 

REM echo TFTP Daemon Started 

REM start pmx -nocopyright 

REM echo X System Server Started 

REM start talkd 

REM echo TALK Daemon Started 

REM start portmap 

REM echo Portmapper Started 

REM start nfsd 

REM echo Network File System Server Started 

REM call nfsstart 

REM echo Network File System Client Started 

REM start routed 

REM echo ROUTED Started 

REM start sendmail -bd -q36m 

REM echo SENDMAIL Started 

REM start nr2 
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NR2 Started 



REM echo 
REM start lamall 

REM echo LAMAIL Started 

REM detach lprportd 

REM echo LPRPORTD Started 

REM echo FINISHED STARTING THE TCP/IP PROCESSES 

IF EXIST C:\TCPIP\BIN\TCPEXIT.CMD CALL C:\TCPIP\BIN\TCPEXIT.CMD 
echo EXITING TCPSTART.CMD 

RESOLV File 

domain itsc.ra1eigh.ibm.com 
nameserver 9.67.38.115 
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Appendix B. Configuration Listings for Non-PS/2 and OEM Hosts 

This appendix lists the configuration files of the OS/2 and DOS systems that were 
used for the scenarios described throughout this document. 



B.1 Configuration of Host RS60007 

The following configuration was used for that system: 



Table 28. System unit and installed software products for host RS60007 


Hardware 


Software 


Functions 


IBM RS/6000 520 H 
Token-Ring Adapter 
Ethernet Adapter 


AIX 3.2.2 


Telnet client/server 
FTP client/server 
NFS client/server 
LPD client/server 
X Window client/server 
Rexec client/server 
Rsh client/server 
IP Router 



B.2 Configuration of Host RALYAS4B 

The following configuration was used for that system: 



Table 29. System unit and installed software products for host RALYAS4B 


Hardware 


Software 


Functions 


IBM AS/400 E20 
Token-Ring Adapter 
Ethernet Adapter 


OS/4Q0 V3R1 
TCP/IP for OS/400 


Telnet client/server 
FTP client/server 



B.3 Configuration of Host WTCESA 

The following configuration was used for that system: 



Table 30. System unit and installed software products for host WTCESA 


Hardware 


Software 


Functions 


IBM ES/9121 
Token Ring (3172) 


VM/ESA 
TCP/IP for VM 


Telnet client/server 
FTP client/server 
Rexec client/server 
Rsh client/server 
NFS server 
LPD client/server 
X Window client 
IP Router 

SNALINK to MVS18SNA 
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B.4 Configuration of Host MVS18SNA 

The following configuration was used for that system: 



Table 31. System unit and installed software products for host MVS18SNA 1 


Hardware 


Software 


Function* 


IBM ES/30SO 


MVS/ESA 
TCP/IP for MVS 


Telnet client/server 
FTP client/server 
NFS server 
SNAUNK to MARTIN 
SNAUNK to WTCESA 



B.5 Configuration of Host DEC 

The following configuration was used for that system: 



Table 32. System unit and installed software products for host DEC 


Hardware 


Software 


Functions 


DEC MicroVAX II 
Ethernet Adapter 


DEC VMS 
Multinet 3.2 


Telnet client/server 
FTP client/server 
NFS client/server 



B.6 Configuration Files of Host SUN 

The following configuration was used for that system: 



Table 33. System unit and installed software products for host SUN 


Hardware 


Software 


Functions 


SUN SPARC Station 
Ethernet Adapter 


SunOS 4.1.3 


Telnet client/server 
FTP client/server 
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